ColourPicker Class Reference

Encapsulates OS-specific colour picker dialogue system, giving a kernel interface for using whatever colour picker(s) are available. More...

#include <colpick.h>

Inheritance diagram for ColourPicker:

List of all members.

Public Member Functions
	ColourPicker ()
	Creates a colourpicker object Scope: private.
	~ColourPicker ()
	Destructor for a Colour Picker Scope: private.
void	EditColour (ColourList *ParentList, IndexedColour *SourceAndResult, BOOL PreferLineColour=FALSE)
	Converts a ColourValue (0.0 to 1.0) into a byte (0..255) with clipping to handle out-of-gamut values.The main colour picker function. Given an IndexedColour, sets up a colour picker showing that colour, allows the user to edit it, and returns the new colour in said IndexedColour. If the colour is changed, an appropriate ColourChangingMsg will be broadcast.
Static Public Member Functions
static BOOL	GetStatusLineText (String_256 *Result)
static void	UpdateBubbleHelpAndPointer (void)
	Called on Idle (or MouseMove) events to provide bubble help and update the mouse pointer while it is over the colour editor dialogue.
static void	SetBubbleHelp (CGadgetID *GadgetList)
	Set all the bubble help up for the colour picker.
Static Protected Member Functions
static BOOL	GetStatusLineText (ColourEditDlg *Editor, UINT32 GadgetID, String_256 *Result)
	Bodge to get around the fact that DialogOps don't plug into the status line help system. Returns help for the colour editor. Must go via the winoil, as we have to read the mouse position and find the window it's in.
static TCHAR *	HelpCallbackHandler (CWindowID Window, UINT32 Item, void *UserData)
	Help callback handler to provide bubble help for the colour editor.
static BOOL	GetComponentHelp (ColourContext *const pSourceContext, const UINT32 ComponentIndex, StringBase &HelpString)
	Subprocedure for HelpCallbackHandler providing help for each of the colour components.
static BOOL	GetComponentAsString (IndexedColour *Source, ColourContext *DestContext, INT32 ComponentIndex, String_8 *Result)
	Retrieves the colour definition of the given colour, converts it to the given colour model, and returns the desired component of the definition in that model as a decimal string appropriate for placing into a colour editor dialogue gadget.
static BOOL	GetComponentsAsHexString (IndexedColour *Source, ColourContext *DestContext, INT32 ComponentIndex, String_16 *Result)
	Retrieves the colour definition of the given colour, converts it to the given colour model, and returns the combined value of all components of the definition in that model as a hexadecimal string appropriate for placing into a colour editor dialogue gadget.
static BOOL	SetComponentFromString (IndexedColour *Dest, ColourContext *SourceContext, INT32 ComponentIndex, String_8 *NewValue)
	Converts AND COERCES the colour into the destination context. Assumes that the string will be 0..100 (or 0..360 for HSV) Clips the string value into a 0.0 to 1.0 in-gamut range, and then sets the given component of the converted colour to that value. This thus changes the colour model in which the colour is defined as well as the component value.
static BOOL	SetComponentsFromHexString (IndexedColour *Dest, ColourContext *SourceContext, String_16 *NewValue)
	Converts AND COERCES the colour into the destination context. Assumes that the string will in hex format (i.e rrggbb or 0xrrggbb) Clips the string value into 0.0 to 1.0 in-gamut ranges, and then sets the components of the converted colour to those values. This thus changes the colour model in which the colour is defined as well as the component value.
static BOOL	IsValidHexString (String_16 Hex)
	Internal helper function for ColourPicker::SetComponentsFromHexString () UNLESS YOU KNOW WHAT YOUR DOING - DON'T CALL THIS AS IT ONLY EXISTS TO HELP THE FORE-MENTIONED FUNCTION - AND I CANNOT SEE WHY YOUR CALLING THIS FROM ELSEWHERE ANYWAY !!!!
static BOOL	SetComponentFromDouble (IndexedColour *Dest, ColourContext *SourceContext, INT32 ComponentIndex, double NewValue)
	Converts AND COERCES the colour into the destination context. Clips the new value into a 0.0 to 1.0 in-gamut range, and then sets the given component of the converted colour to that value.
static void	ForceColourModel (IndexedColour *Dest, ColourContext *SourceContext)
	COERCES the colour into the destination context. This ensures that the colour is defined in the given context's colour model, converting its definition if necessary.
static BOOL	GetTintAsString (IndexedColour *Source, StringBase *Result)
	Retrieves the tint of the given colour as a decimal string appropriate for placing into a colour editor dialogue gadget.
static BOOL	SetTintFromString (IndexedColour *Dest, StringBase *NewValue)
	Assumes that the string will be 0..100 Clips the string value into a 0.0 to 1.0 in-gamut range, and then sets the tint component of the converted colour to that value.
static BOOL	GetShadeValueAsString (IndexedColour *Source, INT32 ValueIndex, StringBase *Result)
	Retrieves the shade of the given colour as a decimal string appropriate for placing into a colour editor dialogue gadget.
static BOOL	SetShadeFromStrings (IndexedColour *Dest, StringBase *NewValueX, StringBase *NewValueY)
	Assumes that the string will be -100..100 Clips the string value into a -1.0 to 1.0 in-gamut range, and then sets the shade components of the converted colour to those values.
static void	SetWindowExtent (CWindowID WindowID, CGadgetID XGadgetID, CGadgetID YGadgetID)
	Private function used by the kernel ColourEditDlg editor. Given a WindowID and GadgetID (cf DialogOp->DialogMgr interface), this sets the window extent of the window to a short distance outside the right/ bottom edges of the X/Y named gadgets respectively.
static void	SetGadgetPositions (CWindowID WindowID, CGadgetID *Gadgets, CGadgetID MoveUnder)
	Private function used by the kernel ColourEditDlg editor. Given a WindowID and GadgetIDs (cf DialogOp->DialogMgr interface), this moves all the gadgets such that (a) All the gadgets in the group remain in the same relative positions, and (b) the Gadgets[0] gadget is moved to lie just underneath the MoveUnder gadget.
static void	SetComponentGadgets (CWindowID WindowID, CGadgetID *Gadgets, CGadgetID PickerGadget, ColourModel ModelToDisplay)
	Private function used by the kernel ColourEditDlg editor.
static void	SetFixedComponentGadgets (CWindowID WindowID, CGadgetID *Gadgets, CGadgetID PickerGadget, ColourModel ModelToDisplay, INT32 TextWidth[], INT32 EditWidth[])
	Private function used by the kernel ColourEditDlg editor.
static void	RelayoutDialog (CWindowID WindowID)
	Ensure the dialog is a sensible size Scope: Protected.
static void	OnSize (CWindowID WindowID)
	Respond to size events Scope: Protected.
static void	RecursiveBestSize (wxWindow *pwxWindow)
	Initialize platform dependent resources.
static BOOL	OnIdleEvent (CWindowID WindowID)
	Respond idle events Scope: Protected.
static void	OnCreate (CWindowID WindowID)
	Respond to size events Scope: Protected.
static void	ArtificialSizeEvents (CWindowID WindowID)
	Produce artificial size events recursively Scope: Protected.
Static Private Attributes
static wxSize	s_LastSize = wxDefaultSize
static wxSize	s_UserSize = wxSize(245,245)
static wxSize	s_MinSize = wxSize(180,100)
static BOOL	s_InColourDialogLayout = FALSE
static BOOL	s_JustCreated = FALSE
static INT32	s_IdleCounter = 0
Friends
class	ColourEditDlg
class	ColourLinkDlg
class	NewColourDlg

---

Detailed Description

Encapsulates OS-specific colour picker dialogue system, giving a kernel interface for using whatever colour picker(s) are available.

Author:

Jason_Williams (Xara Group Ltd) <camelotdev@xara.com>

Date:

13/5/95

Given a (named or unnamed) IndexedColour, a Colour Picker somehow provides a user interface to change it, and returns the colour, cleaner and brighter than you ever thought possible, and for only about the same price as you'd expect to pay for an inferior colour picker. 1 out of 10 home economists prefer our colour picker to all others.

This class also provides secrel-squirrel interfaces for doing rather horrendous direct-pokey Coloue Editor things to IndexedColours. These are only available to our friend editor dialogue classes.

Friends: ColourEditDlg; ColourLinkDlg

See also:

IndexedColour; ColourEditDlg; ColourLinkDlg

Definition at line 138 of file colpick.h.

---

Constructor & Destructor Documentation

ColourPicker::ColourPicker (   )

Creates a colourpicker object Scope: private. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Definition at line 166 of file colpick.cpp. { }

ColourPicker::~ColourPicker (   )

Destructor for a Colour Picker Scope: private. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Definition at line 188 of file colpick.cpp. { }

---

Member Function Documentation

void ColourPicker::ArtificialSizeEvents (  CWindowID  WindowID  )  [static, protected]

Produce artificial size events recursively Scope: Protected. Author: Alex Bligh Date: 30/5/2005 Parameters: -  [INPUTS] On GTK at least, sizing does not occur synchronously. Some of it happens on size events from a gtk_window_size_callback. For various reasons (like the necessity for a wxyield) this is not great). So we produce them ourselves. Definition at line 3006 of file colpick.cpp. { if (!WindowID->IsShown()) return; // size children first wxWindowList::Node * pNode = WindowID->GetChildren().GetFirst(); while (pNode) { ArtificialSizeEvents(pNode->GetData()); pNode = pNode->GetNext(); } wxSizeEvent event( WindowID->GetSize(), WindowID->GetId() ); event.SetEventObject( WindowID ); WindowID->GetEventHandler()->ProcessEvent( event ); }

void ColourPicker::EditColour (  ColourList *  ParentList, IndexedColour *  SourceAndResult, BOOL  PreferLineColour = FALSE )

Converts a ColourValue (0.0 to 1.0) into a byte (0..255) with clipping to handle out-of-gamut values.The main colour picker function. Given an IndexedColour, sets up a colour picker showing that colour, allows the user to edit it, and returns the new colour in said IndexedColour. If the colour is changed, an appropriate ColourChangingMsg will be broadcast. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/94 Parameters: ParentList  - The list in which the colour resides [INPUTS] May be NULL if you want to just show the picker for whatever local colour is appropriate. SourceAndResult must also be NULL in this case SourceAndResult - The colour to be edited. If the user changes the colour, this will be set to the new definition. May be NULL if you want to just show the picker for whatever local colour is appropriate. ParentList must also be NULL in this case PreferLineColour - TRUE if you'd like to edit line colours rather than fill colours in local mode, FALSE to edit fill colours. This flag is ignored unless ParentList == SourceAndResult == NULL. (Implementation note: This calls ColourEditDlg::ForceLineOrFillMode) Parameters: -  [OUTPUTS] Returns: - Notes: The IndexedColour is actually copied into another for editing. The change, if OK'd is then applied using the ColourManager::ChangeColour function, which provides an undo record of the event. Scope: private Returns: Errors: - See also: ColourEditDlg::InvokeDialog Definition at line 275 of file colpick.cpp. { #if FALSE /* // **** DEBUG - use Windows Picker if SHIFT NOT held down on entry, // else use the Camelot Picker if (ForceNativePicker) UseOSPicker = TRUE; else UseOSPicker = (::GetAsyncKeyState(CAMKEY(SHIFT)) & 0x8000) ? TRUE : FALSE; // **** if (UseOSPicker) { IndexedColour *UndoBuffer = new IndexedColour(*SourceAndResult); if (UndoBuffer == NULL) // Fail gracefully. Well... Don't crash, anyway return; ColourGeneric *TheColour = UndoBuffer->SourceColourPtr(); Document *ScopeDoc = Document::GetSelected(); if (ScopeDoc == NULL) return; ColourContext *ccRGB = ScopeDoc->GetDefaultColourContexts()->Context[COLOURMODEL_RGBT]; ENSURE(ccRGB != NULL, "Default RGBT context can't be found!"); ColourContext *ccSource = ScopeDoc->GetDefaultColourContexts()->Context[UndoBuffer->GetColourModel()]; if (ccSource == NULL) { ENSURE(FALSE, "Unsupported source colour context - I can't edit that colour"); return; } // Convert the given colour into RGB, using 'pure' contexts (logical rather than physica // conversion, i.e. no colour correction en-route) ColourRGBT TheColourRGB; ccRGB->ConvertColour(ccSource, TheColour, (ColourGeneric *) &TheColourRGB); // Now set up, and call the Windows colour picker to edit the colour... CHOOSECOLOR cc; // Set initial colour for the colour picker to use cc.rgbResult = RGB( ColourValueToByte(TheColourRGB.Red), ColourValueToByte(TheColourRGB.Green), ColourValueToByte(TheColourRGB.Blue) ); // Set the default set of available colours (a greyscale for the time being) // (it is static so that if the user changes any of the colours they will get // the changed palette back next time around) static COLORREF acrCustClr[16] = { RGB(255, 255, 255), RGB(239, 239, 239), RGB(223, 223, 223), RGB(207, 207, 207), RGB(191, 191, 191), RGB(175, 175, 175), RGB(159, 159, 159), RGB(143, 143, 143), RGB(127, 127, 127), RGB(111, 111, 111), RGB(95, 95, 95), RGB(79, 79, 79), RGB(63, 63, 63), RGB(47, 47, 47), RGB(31, 31, 31), RGB(15, 15, 15) }; cc.lStructSize = sizeof(CHOOSECOLOR); cc.hwndOwner = AfxGetApp()->m_pMainWnd->m_hWnd; // 'owner' window cc.lpCustColors = (LPDWORD) acrCustClr; // List of default colours cc.Flags = CC_RGBINIT | CC_FULLOPEN; // Use cc.rgbResult to init picker... // and picker appears fully opened - Geez that // 'define wossnames' button is a pain in the butt!!! if (ChooseColor(&cc)) // Invoke Windows colour picker (if it qualifies as a colour picker!) { // User chose a colour and hit OK - read out the return value (always RGB) UndoBuffer->SetSourceColourModel(COLOURMODEL_RGBT); ((ColourRGBT *)TheColour)->Red = ((double) GetRValue(cc.rgbResult)) / 256.0; ((ColourRGBT *)TheColour)->Green = ((double) GetGValue(cc.rgbResult)) / 256.0; ((ColourRGBT *)TheColour)->Blue = ((double) GetBValue(cc.rgbResult)) / 256.0; ((ColourRGBT *)TheColour)->Transparent = 0; Document::GetSelected()->SetCurrent(); // Make this document the current one // This swallows UndoBuffer into the undo system - we must NOT delete it ColourManager::ChangeColour(ParentList, UndoBuffer, SourceAndResult); } else delete UndoBuffer; // UndoBuffer not used - delete it } else */ #endif { #ifndef STANDALONE // If we are asking to edit an appropriate local colour, state our preference // for either fill or line colour. if (SourceAndResult == NULL) ColourEditDlg::ForceLineOrFillMode(PreferLineColour); ColourEditDlg::InvokeDialog(ParentList, SourceAndResult); #endif } }

void ColourPicker::ForceColourModel (  IndexedColour *  Dest, ColourContext *  SourceContext )  [static, protected]

COERCES the colour into the destination context. This ensures that the colour is defined in the given context's colour model, converting its definition if necessary. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/94 Parameters: Dest  - the colour to be set [INPUTS] SourceContext - the context in which the new colour value should be defined Dest  is updated appropriately [OUTPUTS] Returns: - Notes: This method always flushes the colour's output cache. Scope: private Definition at line 1926 of file colpick.cpp. { ERROR3IF(Dest == NULL || SourceContext == NULL, "ColourPicker::ForceColourModel - NULL Parameters are illegal"); // Invalidate the colour's output cache (even if it hasn't really changed - in this // case we're only causing one weeny little colour conversion, so it's no big deal) // This is also needed because the above functions expect this call to flush the cache. Dest->InvalidateCache(); if (Dest->GetColourModel() != SourceContext->GetColourModel()) { ColourContext *OldContext = ColourContext::GetGlobalDefault(Dest->GetColourModel()); if (OldContext == NULL) { ERROR2RAW("Unable to get colour context for ForceColourModel"); return; } // The colour must be coerced into the new model using secret squirrel private // methods which we can access only because we are a friend of IndexedColour ColourGeneric NewDefn; Dest->GetSourceColour(&NewDefn); // Copy into temp space & convert back into the colour SourceContext->ConvertColour(OldContext, &NewDefn, Dest->SourceColourPtr()); Dest->SetSourceColourModel(SourceContext->GetColourModel()); // and once again, flush the cache to make sure the change in model has been noticed Dest->InvalidateCache(); } }

BOOL ColourPicker::GetComponentAsString (  IndexedColour *  Source, ColourContext *  DestContext, INT32  ComponentIndex, String_8 *  Result )  [static, protected]

Retrieves the colour definition of the given colour, converts it to the given colour model, and returns the desired component of the definition in that model as a decimal string appropriate for placing into a colour editor dialogue gadget. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/94 Parameters: Source  - The colour from which you wish to extract the component [INPUTS] DestContext - The colour context in which you want the resulting component ComponentIndex - The component you wish to extract (1..4) Result  - returns containing a decimal (0.0 .. 100.0) string representing [OUTPUTS] the value of the given component of the colour as it is defined in the given colour model (Note: HSV Hue is done as 0..360). Returns: TRUE if the value converted was out of gamut. Notes: At present, this function clips the value to lie within the legal 0.0 to 1.0 gamut range. Scope: private See also: ColourPicker::SetComponentFromDouble; ColourPicker::SetComponentFromString Definition at line 1238 of file colpick.cpp. { ERROR2IF(Source == NULL || DestContext == NULL || Result == NULL, FALSE, "NULL parameters are illegal"); ERROR2IF(ComponentIndex < 1 || (UINT32)ComponentIndex > DestContext->GetComponentCount(), FALSE, "ComponentIndex not in range"); BOOL OutOfGamut = FALSE; ColourGeneric Defn; DestContext->ConvertColour(Source, &Defn); // Sneakily get the component from the ColourGeneric by treating it as an array // of 4 ColourValue components. ColourValue *CompPtr = (ColourValue *) &Defn; double CompValue = CompPtr[ComponentIndex-1].MakeDouble(); if (CompValue < 0.0) { CompValue = 0.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } if (CompValue > 1.0) { CompValue = 1.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } // Generate a 0..100 value, except for Hue, in which case it's 0..360 UnitGroup* pPossibleUnits = DestContext->GetComponentUnitGroup(ComponentIndex); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::GetComponentAsString - pPossibleUnits NULL"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "pPossibleUnits aren't"); ScaleUnit* pUnit = pPossibleUnits->GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentAsString - Default units NULL"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "pUnits isn't"); pUnit->StringFromScale(CompValue, Result, 6); // Convert to a 1 d.p. string using the global conversion function /* String_32 TempString; Convert::DoubleToString(CompValue, (StringBase *) &TempString, pUnit->GetDPtoShow()); TempString.Left(Result, 6); const Qualifier* pQualifier = pUnit->GetQualifier(); if (pQualifier == NULL || !pQualifier->IS_KIND_OF(Qualifier)) { ERROR3("ColourPicker::GetComponentAsString - not a Qualifier!"); return FALSE; } if (pQualifier->IsShown()) *Result += pQualifier->GetToken(); */ return(OutOfGamut); }

BOOL ColourPicker::GetComponentHelp (  ColourContext *const   pSourceContext, const UINT32  ComponentIndex, StringBase &  HelpString )  [static, protected]

Subprocedure for HelpCallbackHandler providing help for each of the colour components. Author: Colin_Barfoot (Xara Group Ltd) <camelotdev@xara.com> Date: 31/05/96 Parameters: pSourceContext  - the ColourContext in which the component is [INPUTS] ComponentIndex - the index of the component in the colour context (1..GetComponentCount()) HelpString  - a string to be displayed as help for the given component [OUTPUTS] Returns: TRUE : If help string constructed correctly FALSE : otherwise Errors: ERROR2IF's if invalid paramters given ERROR3IF's for corrupt data structures See also: ColourPicker::HelpCallbackHandler Definition at line 979 of file colpick.cpp. { ERROR2IF(pSourceContext == NULL, FALSE, "NULL parameters not allowed"); ERROR3IF(!pSourceContext->IS_KIND_OF(ColourContext), "ColourPicker::GetComponentHelp() - pSourceContext isn't"); ERROR2IF((ComponentIndex < 1) || (ComponentIndex > pSourceContext->GetComponentCount()), FALSE, "Component index out of bounds"); // Create a string of the form "Red (0..100%)" using the colour component's name and the limits defined for // the component's unit UnitGroup* pUnitGroup = pSourceContext->GetComponentUnitGroup(ComponentIndex); if (pUnitGroup == NULL) { ERROR3("ColourPicker::GetComponentHelp - Model has no units"); return FALSE; } ERROR3IF(!pUnitGroup->IS_KIND_OF(UnitGroup), "ColourPicker::GetComponentHelp() - pUnitGroup isn't"); ScaleUnit* pUnit = pUnitGroup->GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentHelp - No default units"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "ColourPicker::GetComponentHelp() - pUnit isn't"); String_64 CompName; pSourceContext->GetComponentName(ComponentIndex, &CompName, TRUE); String_32 LowerLimit; Convert::DoubleToString(pUnit->GetMin(), (StringBase*)&LowerLimit, pUnit->GetDPtoShow()); String_32 UpperLimit; Convert::DoubleToString(pUnit->GetMax(), (StringBase*)&UpperLimit, pUnit->GetDPtoShow()); String_32 QualifierToken; const Qualifier* pQualifier = pUnit->GetQualifier(); if (pQualifier == NULL) { ERROR3("ColourPicker::GetComponentHelp - No qualifier"); return FALSE; } ERROR3IF(!pQualifier->IS_KIND_OF(Qualifier), "ColourPicker::GetComponentHelp - Qualifier isn't"); if (pQualifier->IsShown()) { QualifierToken = pQualifier->GetToken(); } HelpString.MakeMsg(_R(IDS_EDITBH_COMP234), (TCHAR *)CompName, (TCHAR *)LowerLimit, (TCHAR *)UpperLimit, (TCHAR *)QualifierToken); return TRUE; }

BOOL ColourPicker::GetComponentsAsHexString (  IndexedColour *  Source, ColourContext *  DestContext, INT32  ComponentIndex, String_16 *  Result )  [static, protected]

Retrieves the colour definition of the given colour, converts it to the given colour model, and returns the combined value of all components of the definition in that model as a hexadecimal string appropriate for placing into a colour editor dialogue gadget. Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/99 Parameters: Source  - The colour from which you wish to extract the component [INPUTS] DestContext - The colour context in which you want the resulting component ComponentIndex - This should be set to -1 at present (cause we are getting all components; and not one in the range 1-4) Result  - returns containing a hexadecimal string representation (rrggbb) [OUTPUTS] Returns: TRUE if the value converted was out of gamut. Notes: At present, this function clips the value to lie within the legal 0.0 to 1.0 gamut range. Scope: private See also: ColourPicker::GetComponentsAsString; ColourPicker::SetComponentsFromHexString Definition at line 1338 of file colpick.cpp. { ERROR2IF(Source == NULL || DestContext == NULL || Result == NULL, FALSE, "NULL parameters are illegal"); // ERROR2IF(!DestContext->IS_KIND_OF(ColourContextWebRGBT), FALSE, // "SourceContext parameter is not of type ColourContextWebRGBT"); if (ComponentIndex == -1) { BOOL OutOfGamut = FALSE; ColourGeneric Defn; DestContext->ConvertColour(Source, &Defn); // Sneakily get the component from the ColourGeneric by treating it as an array // of 4 ColourValue components .... ColourValue *CompPtr = (ColourValue *) &Defn; String_8 ResultR, ResultG, ResultB; for (INT32 i = 1; i < 4; i++) { double CompValue = CompPtr[i-1].MakeDouble(); if (CompValue < 0.0) { CompValue = 0.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } if (CompValue > 1.0) { CompValue = 1.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } // Generate a 0..100 value, except for Hue, in which case it's 0..360 UnitGroup* pPossibleUnits = DestContext->GetComponentUnitGroup(i); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::GetComponentAsString - pPossibleUnits NULL"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "pPossibleUnits aren't"); ScaleUnit* pUnit = pPossibleUnits->FindUnitFromIndex (1);//GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentAsString - Default units NULL"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "pUnits isn't"); switch (i) { case 1: pUnit->StringFromScale(CompValue, &ResultR, 6); break; case 2: pUnit->StringFromScale(CompValue, &ResultG, 6); break; case 3: pUnit->StringFromScale(CompValue, &ResultB, 6); break; } } // convert strings into integers .... INT32 rVal = camAtoi ((const TCHAR*) ResultR); INT32 gVal = camAtoi ((const TCHAR*) ResultG); INT32 bVal = camAtoi ((const TCHAR*) ResultB); // convert integers to base 16 .... camSprintf((TCHAR*)ResultR, _T("%X"), rVal); camSprintf((TCHAR*)ResultG, _T("%X"), gVal); camSprintf((TCHAR*)ResultB, _T("%X"), bVal); String_8 Builder;//FinalResultR, FinalResultG, FinalResultB; // I don't want an _itoa one length rr's, gg's or bb's thankyou very much! // AND glue the results together (== rrggbb) at the same time if (ResultR.Length () == 1) { Builder += (String_8 (TEXT ("0"))) += ResultR; } else { Builder += ResultR; } if (ResultG.Length () == 1) { Builder += (String_8 (TEXT ("0"))) += ResultG; } else { Builder += ResultG; } if (ResultB.Length () == 1) { Builder += (String_8 (TEXT ("0"))) += ResultB; } else { Builder += ResultB; } *Result = Builder; // take that edit box - a correctly built hex string! //if ((ResultR.Length () == 1) || (ResultG.Length () == 1) || (ResultB.Length () == 1)) //{ // *Result += /*(String_8 (TEXT ("0x"))) +=*/ FinalResultR += FinalResultG += FinalResultB; //} //else //{ // *Result += /*(String_8 (TEXT ("0x"))) +=*/ ResultR += ResultG += ResultB; //} return(OutOfGamut); } return (FALSE); // stop that annoying warning about not all paths return a value! }

BOOL ColourPicker::GetShadeValueAsString (  IndexedColour *  Source, INT32  ValueIndex, StringBase *  Result )  [static, protected]

Retrieves the shade of the given colour as a decimal string appropriate for placing into a colour editor dialogue gadget. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 24/10/95 Parameters: Source  - The colour from which you wish to extract the shade value [INPUTS] ValueIndex - 1 to extract the X component 2 to extract the Y component Result  - returns containing a decimal (-100.0 .. 100.0) string representing [OUTPUTS] the value of the given shade component of the colour Returns: TRUE if the value converted was out of gamut. Notes: At present, this function clips the value to lie within the legal -1.0 to 1.0 gamut range. If the colour is not a shade, will ENSURE and return "0%" Scope: private See also: ColourPicker::SetShadeFromStrings Definition at line 2144 of file colpick.cpp. { ERROR3IF(Source == NULL || Result == NULL, "ColourPicker::GetShadeValueAsString - NULL parameters are illegal"); ERROR3IF(ValueIndex != 1 && ValueIndex != 2, "ColourPicker::GetShadeValueAsString - Illegal ValueIndex parameter"); if (Source->GetType() != COLOURTYPE_TINT) { ERROR3("ColourPicker::GetShadeValueAsString - Source colour isn't a tint"); *Result = String_8(_R(IDS_CONVERT_ZERO_CHAR)); // TEXT("0"); return(FALSE); } BOOL OutOfGamut = FALSE; double CompValue; if (ValueIndex == 1) CompValue = -Source->GetShadeValueX().MakeDouble(); else CompValue = Source->GetShadeValueY().MakeDouble(); if (CompValue < -1.0) { CompValue = -1.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } if (CompValue > 1.0) { CompValue = 1.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } CompValue *= 100.0; String_32 TempString; Convert::DoubleToString(CompValue, (StringBase *) &TempString, 1); TempString.Left(Result, 7); return(OutOfGamut); }

BOOL ColourPicker::GetStatusLineText (  ColourEditDlg *  Editor, UINT32  GadgetID, String_256 *  Result )  [static, protected]

Bodge to get around the fact that DialogOps don't plug into the status line help system. Returns help for the colour editor. Must go via the winoil, as we have to read the mouse position and find the window it's in. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 25/5/95 Parameters: Editor  - points to the current editor [INPUTS] GadgetID - indicates the gadget for which you desire help If  return value is TRUE, Result is updated with an appropriate help string [OUTPUTS] Returns: TRUE if it changed Result, FALSE if it can offer no help See also: ColourEditDlg::GetStatusLineText Definition at line 403 of file colpick.cpp. { #ifndef STANDALONE IndexedColour *Bob = Editor->EditingColour; if (Bob == NULL) { *Result = String_256(_R(IDS_EDITST_NOCOLOUR)); return(TRUE); } ColourContext *cc = ColourContext::GetGlobalDefault(ColourEditDlg::DisplayModel); // Set the default help *Result = String_256(_R(IDS_EDITST_DEFAULT)); if (FALSE) {} // else if (GadgetID == _R(IDCANCEL)) // { // *Result = String_256(_R(IDS_EDITST_CANCEL)); // } else if (GadgetID == _R(IDC_EDIT_DROPMENU)) { *Result = String_256(_R(IDS_EDITST_MENU)); } else if (GadgetID == _R(IDC_EDIT_COMPONENT1)) { if (ColourEditDlg::DisplayModel == COLOURMODEL_HSVT) { *Result = String_256(_R(IDS_EDITST_COMP1)); } else { if (cc != NULL) { String_64 CompName; cc->GetComponentName(1, &CompName, TRUE); Result->MakeMsg(_R(IDS_EDITST_COMP234), (TCHAR *)CompName); } } } else if (GadgetID == _R(IDC_EDIT_COMPONENT2)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(2, &CompName, TRUE); Result->MakeMsg(_R(IDS_EDITST_COMP234), (TCHAR *)CompName); } } else if (GadgetID == _R(IDC_EDIT_COMPONENT3)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(3, &CompName, TRUE); Result->MakeMsg(_R(IDS_EDITST_COMP234), (TCHAR *)CompName); } } // WEBSTER - markn 14/12/96 #ifndef WEBSTER else if (GadgetID == _R(IDC_EDIT_COMPONENT4)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(4, &CompName, TRUE); Result->MakeMsg(_R(IDS_EDITST_COMP234), (TCHAR *)CompName); } } else if (GadgetID == _R(IDC_EDIT_COLMODEL)) { *Result = String_256(_R(IDS_EDITST_COLMODEL)); } else if (GadgetID == _R(IDC_EDIT_NAMEMENU)) { *Result = String_256(_R(IDS_EDITST_NAME)); } else if (GadgetID == _R(IDC_EDIT_COLTYPE)) { *Result = String_256(_R(IDS_EDITST_COLTYPE)); } else if ((GadgetID == _R(IDC_EDIT_INHERIT1)) || (GadgetID == _R(IDC_EDIT_INHERIT2)) || (GadgetID == _R(IDC_EDIT_INHERIT3)) || (GadgetID == _R(IDC_EDIT_INHERIT4))) { *Result = String_256(_R(IDS_EDITST_INHERIT)); } // else if ((GadgetID == _R(IDC_EDIT_PATCH)) || // (GadgetID == _R(IDC_EDIT_PARENTPATCH))) // { // *Result = String_256(_R(IDS_EDITST_PARENTPATCH)); // } else if ((GadgetID == _R(IDC_EDIT_PARENTCOL)) || (GadgetID == _R(IDC_EDIT_PARENTNAME))) { *Result = String_256(_R(IDS_EDITST_PARENTCOL)); } else if ((GadgetID == _R(IDC_EDIT_TINT)) || (GadgetID == _R(IDC_EDIT_TINTSLIDER))) { if (Bob->GetType() == COLOURTYPE_TINT && !Bob->TintIsShade()) *Result = String_256(_R(IDS_EDITST_TINT1)); // It's a tint else *Result = String_256(_R(IDS_EDITST_TINT2)); // It's a shade } else if (GadgetID == _R(IDC_EDIT_SHADE)) { *Result = String_256(_R(IDS_EDITST_TINT2)); // It's a shade } else if (GadgetID == _R(IDC_EDIT_ADVANCED)) { if (Editor->Folded) *Result = String_256(_R(IDS_EDITST_ADVANCED1)); else *Result = String_256(_R(IDS_EDITST_ADVANCED2)); } else if (GadgetID == _R(IDC_EDIT_3D)) { *Result = String_256(_R(IDS_EDITST_3D)); } else if (GadgetID == _R(IDC_EDIT_MAKESTYLE)) { *Result = String_256(_R(IDS_EDITST_MAKESTYLE)); } #endif // WEBSTER else if (GadgetID == _R(IDC_EDIT_PICKER)) { if (!StatusHelpBuffer.IsEmpty()) *Result = StatusHelpBuffer; else { switch(Bob->GetType()) { // WEBSTER - markn 14/12/96 #ifndef WEBSTER case COLOURTYPE_TINT: if (Editor->Folded) *Result = String_256(_R(IDS_EDITST_PICKER1)); else *Result = String_256(_R(IDS_EDITST_PICKER2)); break; case COLOURTYPE_LINKED: *Result = String_256(_R(IDS_EDITST_PICKER3)); break; #endif // WEBSTER case COLOURTYPE_NORMAL: case COLOURTYPE_SPOT: default: *Result = String_256(_R(IDS_EDITST_PICKER4)); break; } } } else if (GadgetID == _R(IDC_EDIT_216ONLY)) { *Result = String_256(_R(IDS_EDITST_216ONLY)); } else if (GadgetID == _R(IDC_COLOURPICKER)) { *Result = String_256(_R(IDS_STATICCOLOURPICKERTOOLHELP)); } else if (GadgetID == _R(IDC_MAKE_LOCAL)) { *Result = String_256(_R(IDS_EDITST_MAKE_LOCAL)); } else if (GadgetID == _R(IDC_EDIT_NOCOLOUR)) { *Result = String_256(_R(IDS_EDITST_SETNOCOLOUR)); } else if (GadgetID == _R(IDC_EDIT_RENAME)) { *Result = String_256(_R(IDS_EDITST_RENAME)); } else if (GadgetID == _R(IDC_EDIT_LINEFILL)) { *Result = String_256(_R(IDS_EDITST_LINEFILL)); } #endif return(TRUE); }

BOOL ColourPicker::GetStatusLineText (  String_256 *  Result  )  [static]

Definition at line 655 of file colpick.cpp. { #ifndef STANDALONE ERROR3IF(Result == NULL, "Illegal NULL param"); ColourEditDlg *Editor = ColourEditDlg::TheEditor; if (Editor == NULL) return(FALSE); // Find the main editor window CWindowID TheWindow = (CWindowID)Editor->WindowID; if (TheWindow == NULL) return(FALSE); wxPoint mousepos = ::wxGetMousePosition(); wxWindow * window=::wxChildWindowFromPoint(TheWindow, mousepos, FALSE, -1); if ((!window) || (window!=::wxChildWindowFromPoint(mousepos, FALSE, -1))) // second check to ensure it is not obscured return FALSE; return GetStatusLineText(Editor, window->GetId(), Result); #else return(TRUE); #endif }

BOOL ColourPicker::GetTintAsString (  IndexedColour *  Source, StringBase *  Result )  [static, protected]

Retrieves the tint of the given colour as a decimal string appropriate for placing into a colour editor dialogue gadget. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/95 Parameters: Source  - The colour from which you wish to extract the tint [INPUTS] Result  - returns containing a decimal (0.0 .. 100.0) string representing [OUTPUTS] the value of the tint component of the colour Returns: TRUE if the value converted was out of gamut. Notes: At present, this function clips the value to lie within the legal 0.0 to 1.0 gamut range. If the colour is not a tint, will ENSURE and return "0%" Scope: private See also: ColourPicker::SetTintFromString Definition at line 1989 of file colpick.cpp. { ERROR3IF(Source == NULL || Result == NULL, "ColourPicker::GetComponentAsString - NULL parameters are illegal"); if (Source->GetType() != COLOURTYPE_TINT) { ERROR3("ColourPicker::GetTintAsString: Source colour isn't a tint"); *Result = String_8(_R(IDS_CONVERT_ZERO_CHAR)); //TEXT("0"); return(FALSE); } BOOL OutOfGamut = FALSE; double CompValue; if (Source->TintIsShade()) CompValue = Source->GetShadeValueY().MakeDouble(); else CompValue = Source->GetTintValue().MakeDouble(); if (CompValue < 0.0) { CompValue = 0.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } if (CompValue > 1.0) { CompValue = 1.0; // **** Clip out-of-gamut values. OutOfGamut = TRUE; // Remember that this was out of gamut } CompValue *= 100.0; String_32 TempString; Convert::DoubleToString(CompValue, (StringBase *) &TempString, 1); TempString.Left(Result, 7); return(OutOfGamut); }

TCHAR * ColourPicker::HelpCallbackHandler (  CWindowID  Window, UINT32  Item, void *  UserData )  [static, protected]

Help callback handler to provide bubble help for the colour editor. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 27/9/95 Parameters: Window  - identifies the window to get help for [INPUTS] Item - identifies the control to get help for UserData - User-supplied data (not used) Returns: The bubble help string to use, or NULL if no help is available See also: ColourPicker::UpdateBubbleHelpAndPointer Definition at line 702 of file colpick.cpp. { #ifndef STANDALONE static String_256 HelpStringStore; BOOL ReturnVal = FALSE; ColourEditDlg *Editor = ColourEditDlg::TheEditor; if (Editor == NULL) return(NULL); IndexedColour *Bob = Editor->EditingColour; ColourContext *cc = NULL; if (Bob != NULL) cc = ColourContext::GetGlobalDefault(ColourEditDlg::DisplayModel); if (FALSE) {} else if (Item == _R(IDC_EDIT_DROPMENU)) { HelpStringStore = String_256(_R(IDS_EDITBH_MENU)); ReturnVal = TRUE; } else if ((Item == _R(IDC_EDIT_PATCH1)) || // Fake ID for current colour patch to give it a unique ID (Item == _R(IDC_EDIT_PATCH2)) || // Fake ID for current colour patch to give it a unique ID (Item == _R(IDC_EDIT_PATCH)) || (Item == _R(IDC_EDIT_PICKER))) { // NOTE: This gives help for "Original/Current colour" patch // We will only get called for this if it is necessary (pointer in correct region of control) HelpStringStore = PickerBubbleBuffer; //String_256(_R(IDS_EDITBH_PARENTPATCH)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_COMPONENT1)) { if (cc) ReturnVal = GetComponentHelp(cc, 1, HelpStringStore); } else if (Item == _R(IDC_EDIT_COMPONENT2)) { if (cc) ReturnVal = GetComponentHelp(cc, 2, HelpStringStore); } else if (Item == _R(IDC_EDIT_COMPONENT3)) { if (cc) ReturnVal = GetComponentHelp(cc, 3, HelpStringStore); } else if (Item == _R(IDC_EDIT_COMPONENT4)) { if (cc) ReturnVal = GetComponentHelp(cc, 4, HelpStringStore); } #if 0 { if (ColourEditDlg::DisplayModel == COLOURMODEL_HSVT) { HelpStringStore = String_256(_R(IDS_EDITBH_COMP1)); ReturnVal = TRUE; } else { if (cc != NULL) { String_64 CompName; cc->GetComponentName(1, &CompName, TRUE); HelpStringStore.MakeMsg(_R(IDS_EDITBH_COMP234), (TCHAR *)CompName); ReturnVal = TRUE; } } } else if (Item == _R(IDC_EDIT_COMPONENT2)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(2, &CompName, TRUE); HelpStringStore.MakeMsg(_R(IDS_EDITBH_COMP234), (TCHAR *)CompName); ReturnVal = TRUE; } } else if (Item == _R(IDC_EDIT_COMPONENT3)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(3, &CompName, TRUE); HelpStringStore.MakeMsg(_R(IDS_EDITBH_COMP234), (TCHAR *)CompName); ReturnVal = TRUE; } } else if (Item == _R(IDC_EDIT_COMPONENT4)) { if (cc != NULL) { String_64 CompName; cc->GetComponentName(4, &CompName, TRUE); HelpStringStore.MakeMsg(_R(IDS_EDITBH_COMP234), (TCHAR *)CompName); ReturnVal = TRUE; } } #endif else if (Item == _R(IDC_EDIT_COLMODEL)) { HelpStringStore = String_256(_R(IDS_EDITBH_COLMODEL)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_NAMEMENU)) { HelpStringStore = String_256(_R(IDS_EDITBH_NAME)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_WEBHEX)) { HelpStringStore = String_256(_R(IDS_EDITBH_WEBHEX)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_COLTYPE)) { HelpStringStore = String_256(_R(IDS_EDITBH_COLTYPE)); ReturnVal = TRUE; } else if ((Item == _R(IDC_EDIT_INHERIT1)) || (Item == _R(IDC_EDIT_INHERIT2)) || (Item == _R(IDC_EDIT_INHERIT3)) || (Item == _R(IDC_EDIT_INHERIT4)) ) { HelpStringStore = String_256(_R(IDS_EDITBH_INHERIT)); ReturnVal = TRUE; } else if ((Item == _R(IDC_EDIT_PARENTCOL)) || (Item == _R(IDC_EDIT_PARENTNAME))) { HelpStringStore = String_256(_R(IDS_EDITBH_PARENTCOL)); ReturnVal = TRUE; } else if ((Item == _R(IDC_EDIT_TINT)) || (Item == _R(IDC_EDIT_TINTSLIDER))) { if (Bob != NULL && Bob->GetType() == COLOURTYPE_TINT && !Bob->TintIsShade()) HelpStringStore = String_256(_R(IDS_EDITBH_TINT1)); // It's a tint else HelpStringStore = String_256(_R(IDS_EDITBH_TINT2)); // It's a shade ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_SHADE)) { HelpStringStore = String_256(_R(IDS_EDITBH_TINT2)); // It's a shade ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_ADVANCED)) { if (Editor->Folded) HelpStringStore = String_256(_R(IDS_EDITBH_ADVANCED1)); else HelpStringStore = String_256(_R(IDS_EDITBH_ADVANCED2)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_3D)) { HelpStringStore = String_256(_R(IDS_EDITBH_3D)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_MAKESTYLE)) { HelpStringStore = String_256(_R(IDS_EDITBH_MAKESTYLE)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_NOCOLOUR)) { HelpStringStore = String_256(_R(IDS_COLBAR_HNOCOLOUR)); ReturnVal = TRUE; } else if (Item == _R(IDC_MAKE_LOCAL)) { HelpStringStore = String_256(_R(IDS_EDITBH_MAKE_LOCAL)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_RENAME)) { HelpStringStore = String_256(_R(IDS_EDITBH_RENAME)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_LINEFILL)) { HelpStringStore = String_256(_R(IDS_EDITBH_LINEFILL)); ReturnVal = TRUE; } else if (Item == _R(IDC_EDIT_216ONLY)) { HelpStringStore = String_256(_R(IDS_EDITBH_216ONLY)); ReturnVal = TRUE; } else if (Item == _R(IDC_COLOURPICKER)) { HelpStringStore = String_256(_R(IDS_STATICCOLOURPICKERTOOLHELP)); ReturnVal = TRUE; } if (ReturnVal) return((TCHAR *) HelpStringStore); #endif return(NULL); }

BOOL ColourPicker::IsValidHexString (  String_16  Hex  )  [static, protected]

Internal helper function for ColourPicker::SetComponentsFromHexString () UNLESS YOU KNOW WHAT YOUR DOING - DON'T CALL THIS AS IT ONLY EXISTS TO HELP THE FORE-MENTIONED FUNCTION - AND I CANNOT SEE WHY YOUR CALLING THIS FROM ELSEWHERE ANYWAY !!!! Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/99 Parameters: Hex  - the string to interrogate to see if all characters are trully [INPUTS] hexadecimal. Returns: TRUE if success (i.e. all characters in string were hexadecimal) Scope: private See also: ColourPicker::GetComponentAsHexString Definition at line 1551 of file colpick.cpp. { for (INT32 i = 0; i < Hex.Length(); i++) { char x = Hex[i]; if (x >= '0' && x <= '9') {} else if (x >= 'A' && x <= 'F') {} else if (x >= 'a' && x <= 'f') {} else { return (FALSE); } } return (TRUE); }

void ColourPicker::OnCreate (  CWindowID  WindowID  )  [static, protected]

Respond to size events Scope: Protected. Author: Alex Bligh Date: 30/5/2005 Parameters: -  [INPUTS] Definition at line 3100 of file colpick.cpp. { s_IdleCounter=0; s_JustCreated=TRUE; // Fix the window size so Open doesn't overwrite it (grrrr) wxWindow * pPicker=DialogManager::GetGadget(WindowID, _R(IDC_EDIT_PICKER)); if (pPicker && (s_UserSize != wxDefaultSize)) { // Ensure no amount of sizing uses a different size for the picker to the one we want pPicker->SetSize(pPicker->GetSize().GetWidth()+1, pPicker->GetSize().GetHeight()+1); // cause a resize WindowID->Layout(); WindowID->Fit(); wxSizer *pSizer = WindowID->GetSizer(); if (pSizer) pSizer->SetSizeHints(WindowID); pPicker->SetMinSize(s_UserSize); pPicker->SetMaxSize(s_UserSize); pPicker->SetSize(s_UserSize); } }

BOOL ColourPicker::OnIdleEvent (  CWindowID  WindowID  )  [static, protected]

Respond idle events Scope: Protected. Author: Alex Bligh Date: 30/5/2005 Parameters: -  [INPUTS] Definition at line 3068 of file colpick.cpp. { if (s_InColourDialogLayout) return FALSE; // That's not a real idle if (s_IdleCounter>0) { s_IdleCounter--; } if (s_JustCreated && !s_IdleCounter) { // We've just been created so we need to do a post open resize s_JustCreated=FALSE; RelayoutDialog(WindowID); } return (s_IdleCounter!=0); // we want more events }

void ColourPicker::OnSize (  CWindowID  WindowID  )  [static, protected]

Respond to size events Scope: Protected. Author: Alex Bligh Date: 30/5/2005 Parameters: -  [INPUTS] Definition at line 3036 of file colpick.cpp. { wxWindow * pGadget = DialogManager::GetGadget(WindowID, _R(IDC_EDIT_PICKER)); if (pGadget) { wxSize NewSize = pGadget->GetSize(); if (s_LastSize != NewSize) { // Record the new size s_LastSize = NewSize; if (!s_InColourDialogLayout && !s_IdleCounter && WindowID->IsShown()) { // It must have been user initiated s_UserSize = NewSize; } } } }

void ColourPicker::RecursiveBestSize (  wxWindow *  pwxWindow  )  [static, protected]

Initialize platform dependent resources. Author: Alex_Bligh <alex@alex.org.uk> Date: 02/12/2005 Parameters: pWindow  - pointer to window to process [INPUTS] None  [OUTPUTS] Returns: None Errors: - See also: - Definition at line 2867 of file colpick.cpp. { if (pwxWindow->IsShown()) { // Now process children if any wxWindowList::Node * pNode = pwxWindow->GetChildren().GetFirst(); while (pNode) { RecursiveBestSize(pNode->GetData()); pNode = pNode->GetNext(); } } pwxWindow->InvalidateBestSize(); wxSizer * s=pwxWindow->GetSizer(); // Shrink this window around any sizer it contains pwxWindow->Layout(); pwxWindow->Fit(); if (s) s->SetSizeHints(pwxWindow); if (pwxWindow->IsShown()) if ((s_UserSize != wxDefaultSize) && ((ResourceID)(pwxWindow->GetId()) == _R(IDC_EDIT_PICKER))) pwxWindow->SetSize(s_UserSize); else pwxWindow->SetSize(pwxWindow->GetMinSize()); else pwxWindow->SetSize(wxSize(1,1)); return; }

void ColourPicker::RelayoutDialog (  CWindowID  WindowID  )  [static, protected]

Ensure the dialog is a sensible size Scope: Protected. Author: Alex Bligh Date: 30/5/2005 Parameters: -  [INPUTS] Definition at line 2913 of file colpick.cpp. { static INT32 flag=0; if (s_InColourDialogLayout) { TRACEUSER("amb", _T("Recursive colour dialog layout")); return; // this should not happen } s_InColourDialogLayout = TRUE; wxWindow * pPicker=DialogManager::GetGadget(WindowID, _R(IDC_EDIT_PICKER)); if (pPicker) pPicker->Freeze(); WindowID->Freeze(); if (pPicker && (s_UserSize != wxDefaultSize)) { // Ensure no amount of sizing uses a different size for the picker to the one we want pPicker->SetSize(pPicker->GetSize().GetWidth()+1, pPicker->GetSize().GetHeight()+1); // cause a resize WindowID->Layout(); WindowID->Fit(); wxSizer * pSizer = WindowID->GetSizer(); if (pSizer) pSizer->SetSizeHints(WindowID); pPicker->SetMinSize(s_UserSize); pPicker->SetMaxSize(s_UserSize); pPicker->SetSize(s_UserSize); } RecursiveBestSize(WindowID); ArtificialSizeEvents(WindowID); if (!flag) { flag++; wxPlatformDependent::Get()->RealYield(); flag--; } // And now do it again with the minimum size for the colour picker restored so the dialog // can shrink if (pPicker && (s_UserSize != wxDefaultSize)) { // If s_JustCreated is set, use s_UserSize pPicker->SetMinSize((s_JustCreated && (s_UserSize != wxDefaultSize))?s_UserSize:s_MinSize); pPicker->SetMaxSize(wxDefaultSize); } RecursiveBestSize(WindowID); ArtificialSizeEvents(WindowID); if (!flag) { flag++; wxPlatformDependent::Get()->RealYield(); flag--; } WindowID->Thaw(); if (pPicker) { pPicker->Thaw(); pPicker->Refresh(); } // Now, even having done the above, believe it or not some of the GTK sizing code seems // to run off idles. So we have to ignore some OnSize events because the idle events // may not be out the system yet. Sigh... Why can't GTK resize sychronously? s_IdleCounter = 3; // 3 more idle counts before we use an OnSize (somewhat arbitrary) GetApplication()->NeedMoreIdles(); // wake up idle system s_InColourDialogLayout = FALSE; }

void ColourPicker::SetBubbleHelp (  CGadgetID *  GadgetList  )  [static]

Set all the bubble help up for the colour picker. Author: Alex Bligh <alex@alex.org.uk> Date: 31/5/2006 Parameters: GadgetList  - NULL terminated list of gadgets [INPUTS] Returns: - See also: - Definition at line 930 of file colpick.cpp. { ColourEditDlg *Editor = ColourEditDlg::TheEditor; if (Editor == NULL) return; CGadgetID i; while ((i=*(GadgetList++))) // assignment { wxWindow * pGadget = DialogManager::GetGadget(Editor->WindowID, i); wxString s; if (pGadget) { if (pGadget->IsEnabled() && pGadget->IsShown()) { // This is OK because HelpCallbackHandler uses a disgusting static. Not my doing TCHAR * pHelp = HelpCallbackHandler(Editor->WindowID, i, NULL); if (pHelp) s=wxString(pHelp); } if (!s.IsEmpty()) pGadget->SetToolTip(s); else pGadget->SetToolTip(NULL); } } }

BOOL ColourPicker::SetComponentFromDouble (  IndexedColour *  Dest, ColourContext *  SourceContext, INT32  ComponentIndex, double  NewValue )  [static, protected]

Converts AND COERCES the colour into the destination context. Clips the new value into a 0.0 to 1.0 in-gamut range, and then sets the given component of the converted colour to that value. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 30/11/94 Parameters: Dest  - the colour to be set [INPUTS] SourceContext - the context in which the new component value is defined ComponentIndex - the index [1..4] of the component being set, in that context NewValue - the new value (0.0 - 1.0) of the component Dest  is updated appropriately [OUTPUTS] Returns: TRUE if the value was out of gamut and had to be clipped This thus changes the colour model in which the colour is defined as well as the component value. The value is rounded as it is squeezed into the Fixed24 format used in colour definitions. Scope: private See also: ColourPicker::SetComponentFromString; ColourPicker::GetComponentAsString Definition at line 1862 of file colpick.cpp. { BOOL OutOfGamut = FALSE; ERROR3IF(Dest == NULL || SourceContext == NULL, "ColourPicker::SetComponentFromDouble - NULL Parameters are illegal"); ERROR3IF(ComponentIndex < 1 || ComponentIndex > 4, "ColourPicker::SetComponentFromDouble- Index should be in range 1..4!"); // Ensure it is in the correct colour model, and flush its output cache ForceColourModel(Dest, SourceContext); // Add half of the least-significant-bit-value to round the new value NewValue += 1.0 / ((double) (1<<25)); // Clip to lie within gamut if (NewValue < 0.0) { NewValue = 0.0; OutOfGamut = TRUE; } if (NewValue > 1.0) { NewValue = 1.0; OutOfGamut = TRUE; } // Sneakily place the component back into the ColourGeneric by treating it as an array // of 4 ColourValue components. ColourValue *CompPtr = (ColourValue *) Dest->SourceColourPtr(); CompPtr[ComponentIndex-1] = FIXED24(NewValue); return(OutOfGamut); }

BOOL ColourPicker::SetComponentFromString (  IndexedColour *  Dest, ColourContext *  SourceContext, INT32  ComponentIndex, String_8 *  NewValue )  [static, protected]

Converts AND COERCES the colour into the destination context. Assumes that the string will be 0..100 (or 0..360 for HSV) Clips the string value into a 0.0 to 1.0 in-gamut range, and then sets the given component of the converted colour to that value. This thus changes the colour model in which the colour is defined as well as the component value. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/94 Parameters: Dest  - the colour to be set [INPUTS] SourceContext - the context in which the new component value is defined ComponentIndex - the index [1..4] of the component being set, in that context NewValue - new value (decimal, as 0..100 or 0..360 for Hue) of the component Dest  is updated appropriately [OUTPUTS] Returns: TRUE if the value was out of gamut and had to be clipped Scope: private See also: ColourPicker::SetComponentFromDouble; ColourPicker::GetComponentAsString Definition at line 1500 of file colpick.cpp. { ERROR2IF(Dest == NULL || SourceContext == NULL || NewValue == NULL, FALSE, "NULL Parameters are illegal"); ERROR3IF(!Dest->IS_KIND_OF(IndexedColour) || !SourceContext->IS_KIND_OF(ColourContext), "Parameters incorrect classes"); ERROR2IF(ComponentIndex < 1 || (UINT32)ComponentIndex > SourceContext->GetComponentCount(), FALSE, "ComponentIndex not in range"); UnitGroup* pPossibleUnits = SourceContext->GetComponentUnitGroup(ComponentIndex); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::SetComponentFromString - SourceContext has NULL units"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "ColourPicker::SetComponentFromString - pPossibleUnits aren't"); double dNewVal; if (pPossibleUnits->ScaleFromString(*NewValue, dNewVal) == FALSE) return FALSE; // And set the new value return(SetComponentFromDouble(Dest, SourceContext, ComponentIndex, dNewVal)); }

void ColourPicker::SetComponentGadgets (  CWindowID  WindowID, CGadgetID *  Gadgets, CGadgetID  PickerGadget, ColourModel  ModelToDisplay )  [static, protected]

Private function used by the kernel ColourEditDlg editor. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 5/4/95 Parameters: WindowID  - The DialogOp->WindowID member variable of the Dialogue [INPUTS] Gadgets - A NULL-terminated list of Gadget IDs of the gadgets to be moved/resized. There MUST be 8 gadget IDs, paired up into (name,writable) sets. PickerGadget - specifies the gadget under which the controls are spaced. If they can be fitted, they will maybe be centered under this control in order to look neater. ModelToDisplay - Indicates the model you're going to put into the controls This is used to determine how many components should be shown and stuff. This takes the 4 component names and component writable fields and spreads them out within the window to allow the names to go next to the writables. The name fileds are resized to fill the available spaces, so you should make them right-aligned to keep the text a set disatnce from the writable for all colour models. It's still up to you to set the contents of the controls, and hide any extra ones (so as much of this crap goes into the kernel as possible). This only changes the positions of the first NumComponents control-pairs. It also hides ALL of the windows. This means that while swapping models they go off and on, but it looks a lot better than the user seeing all the faffing arounf as they are moved, resized, and have their contents changed. Scope: private Definition at line 2533 of file colpick.cpp. { PORTNOTE("other", "Disabled ColourPicker::SetComponentGadgets") #ifndef EXCLUDE_FROM_XARALX // Find out how many visible components we're dealing with... ColourContext *cc = ColourContext::GetGlobalDefault(ModelToDisplay); INT32 NumComponents = 0; INT32 i; if (cc != NULL) { for (i = 1; i <= 4; i++) { if (cc->GetComponentName(i, NULL)) NumComponents++; } } if (NumComponents < 1) return; RECT TheRect; CWindowID hGadget; INT32 Left = 8; INT32 MaxWidth = 0; // if (NumComponents < 3) { // Use width of colour picker control hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)PickerGadget); if (hGadget && GetWindowRect(hGadget, &TheRect)) { // convert screen rect to client position within the parent wnd ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &TheRect, 2); MaxWidth = TheRect.right - TheRect.left; Left = TheRect.left; } } /* else { // Use width of the window if (GetClientRect((CWindowID)WindowID, &TheRect)) { MaxWidth = TheRect.right - TheRect.left; MaxWidth -= 2 * Left; } } */ if (MaxWidth < 1) return; // We must now fit NumComponents items into MaxWidth pixels INT32 PairWidth = MaxWidth / NumComponents; // Read the writable control size and y position static INT32 BaseWritableWidth = 0; hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[1]); if (GetWindowRect(hGadget, &TheRect)) { // Only read the static writable width the first time we do this, // so that we remember the original size before we started resizing these controls if (BaseWritableWidth == 0) BaseWritableWidth = TheRect.right - TheRect.left; } INT32 WritableWidth = BaseWritableWidth; if (WritableWidth < 1) return; // If doing 4 components, we use the width of the original writable controls // If doing fewer components, we make the writables a bit bigger, as there // is some spare room around to absorb. if (NumComponents < 4) WritableWidth += 4; // WEBSTER - markn 9/1/97 // We make the room available to the ed fields for HSV be the same as RGB // The WritableWidth used to only be adjusted for RGB // // The RGBT model has even more room availble ... if (ModelToDisplay == COLOURMODEL_RGBT || ModelToDisplay == COLOURMODEL_HSVT) WritableWidth += 8; const INT32 Gap = 3; // Min. gap between adjacent fields if (PairWidth - (2*Gap + WritableWidth) > 64) { // There is heaps of space. Limit to the max size, and shift the left // and maxwidth to keep the controls centered. PairWidth = 64 + 2*Gap + WritableWidth; Left += (MaxWidth - (NumComponents * PairWidth)) / 2; MaxWidth = NumComponents * PairWidth; } // Convert the rect from screen to client coords within the parent wnd. ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &TheRect, 2); // Find the top/bottom position for the text gadgets, in client coords RECT TextRect; hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[0]); if (hGadget == NULL || !GetWindowRect(hGadget, &TextRect)) return; ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &TextRect, 2); // For each component, place the controls const INT32 NewWidth = PairWidth - (2*Gap + WritableWidth); const INT32 NewHeight = ABS(TheRect.bottom - TheRect.top); // Don't change the height INT32 LeftEnd; for (i = 0; i < NumComponents; i++) { LeftEnd = Left + (i * PairWidth); // Move and resize (in x axis only) the text gadget hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[i*2]); if (hGadget) { if (i < NumComponents) { SetWindowPos(hGadget, NULL, LeftEnd, TextRect.top, NewWidth, NewHeight, SWP_HIDEWINDOW | SWP_NOACTIVATE | SWP_NOZORDER | SWP_NOCOPYBITS | SWP_NOREDRAW); } else ShowWindow(hGadget, SW_HIDE); } LeftEnd += NewWidth + Gap; // Move (in x axis only) the writable gadget hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[(i*2)+1]); if (hGadget) { if (i < NumComponents) { SetWindowPos(hGadget, NULL, LeftEnd, TheRect.top, WritableWidth, NewHeight, SWP_HIDEWINDOW | SWP_NOACTIVATE | SWP_NOZORDER | SWP_NOCOPYBITS | SWP_NOREDRAW); } else ShowWindow(hGadget, SW_HIDE); } } // Finally, redraw the affected strip of the window, because the controls won't TheRect.left = 0; // Left edge of window TheRect.right = 0x1000; // Infinity as far as the window is concerned ::InvalidateRect((CWindowID)WindowID, &TheRect, TRUE); #endif }

BOOL ColourPicker::SetComponentsFromHexString (  IndexedColour *  Dest, ColourContext *  SourceContext, String_16 *  NewValue )  [static, protected]

Converts AND COERCES the colour into the destination context. Assumes that the string will in hex format (i.e rrggbb or 0xrrggbb) Clips the string value into 0.0 to 1.0 in-gamut ranges, and then sets the components of the converted colour to those values. This thus changes the colour model in which the colour is defined as well as the component value. Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/99 Parameters: Dest  - the colour to be set [INPUTS] SourceContext - the context in which the new component value is defined NewValue - new value (hexadecimal) of the components (i.e. rrggbb or 0xrrggbb) Dest  is updated appropriately [OUTPUTS] Returns: TRUE if success (i.e. valid input and we could do things) Scope: private See also: ColourPicker::SetComponentFromDouble; ColourPicker::GetComponentAsHexString Definition at line 1600 of file colpick.cpp. { ERROR2IF(Dest == NULL || SourceContext == NULL || NewValue == NULL, FALSE, "NULL Parameters are illegal"); ERROR3IF(!Dest->IS_KIND_OF(IndexedColour) || !SourceContext->IS_KIND_OF(ColourContext), "Parameters incorrect classes"); // ERROR2IF(!SourceContext->IS_KIND_OF(ColourContextWebRGBT), FALSE, // "SourceContext parameter is not of type ColourContextWebRGBT"); // take a copy of the string - since were going to have to interrogate/parse it .... String_16 CopyNewValue (*NewValue); // convert to lower case (avoid trouble with caps etc.) CopyNewValue.toLower (); INT32 StringLength = CopyNewValue.Length ();//camStrlen ((TCHAR*) CopyNewValue); BOOL ValidStringParseSoFar = TRUE; BOOL Single0xPrefix = FALSE; BOOL SingleHashPrefix = FALSE; BOOL More0xPrefixs = FALSE; BOOL MoreHashPrefixs = FALSE; // decide if we have a 0x prefix, or a # prefix .... const TCHAR* PtrPrefix = cc_lstrstr (CopyNewValue, _T("0x")); Single0xPrefix = (PtrPrefix != NULL) ? TRUE : FALSE; const TCHAR* PtrPrefix2 = cc_lstrstr (CopyNewValue, _T("#")); SingleHashPrefix = (PtrPrefix2 != NULL) ? TRUE : FALSE; if (Single0xPrefix == TRUE) { CopyNewValue = PtrPrefix += 2; // not quite and simple as this - since we now need to see if theres (at least) one // other 0x - and if there is, ABORT (since that cannot be a valid hex number) PtrPrefix = cc_lstrstr (CopyNewValue, _T("0x")); More0xPrefixs = (PtrPrefix != NULL) ? TRUE : FALSE; ValidStringParseSoFar = More0xPrefixs ? FALSE : TRUE; if (ValidStringParseSoFar) { // scan for # .... PtrPrefix2 = cc_lstrstr ((const TCHAR*) CopyNewValue, _T("#")); SingleHashPrefix = (PtrPrefix2 != NULL) ? TRUE : FALSE; ValidStringParseSoFar = SingleHashPrefix ? FALSE : TRUE; } if (!ValidStringParseSoFar) { return (FALSE); } } else if (SingleHashPrefix == TRUE) { CopyNewValue = PtrPrefix2 += 1; // not quite and simple as this - since we now need to see if theres (at least) one // other # - and if there is, ABORT (since that cannot be a valid hex number) PtrPrefix2 = cc_lstrstr ((const TCHAR*) CopyNewValue, _T("#")); MoreHashPrefixs = (PtrPrefix2 != NULL) ? TRUE : FALSE; ValidStringParseSoFar = MoreHashPrefixs ? FALSE : TRUE; if (ValidStringParseSoFar) { // scan for 0x .... PtrPrefix = cc_lstrstr ((const TCHAR*) CopyNewValue, _T("0x")); Single0xPrefix = (PtrPrefix != NULL) ? TRUE : FALSE; ValidStringParseSoFar = Single0xPrefix ? FALSE : TRUE; } if (!ValidStringParseSoFar) { return (FALSE); } } if (ValidStringParseSoFar == FALSE) return (FALSE); // weve made it this far - and have removed the trailing 0x // so now take a copy of the this new (copied) string and lets try to break // the string into components .... String_16 No0xPrefixNewValue (CopyNewValue); StringLength = No0xPrefixNewValue.Length (); BOOL rComponent = FALSE; BOOL bComponent = FALSE; BOOL gComponent = FALSE; String_8 rValStr; String_8 gValStr; String_8 bValStr; if ((StringLength <= 0) || (StringLength > 6)) return (FALSE); switch (StringLength) { case 2: rComponent = TRUE; break; case 4: rComponent = TRUE; gComponent = TRUE; break; case 6: rComponent = TRUE; gComponent = TRUE; bComponent = TRUE; break; } BOOL returnVal = FALSE; // now break the string and do conversions .... // NOTE - I could have made use of a for/while loop to reduce code size here; BUT // when I tried the BLOODY thing kept falling over - and it didn't seem worth it // for all the hastle .... if (IsValidHexString (No0xPrefixNewValue)) { if (rComponent == TRUE) // deal with the red component { No0xPrefixNewValue.Split (&rValStr, &No0xPrefixNewValue, 2, FALSE); INT32 convertedVal; camSscanf(rValStr, _T("%X"), &convertedVal); camSprintf(rValStr, _T("%d"), convertedVal); //INT32 convertedVal = (INT32) strtol ((TCHAR*) rValStr, (TCHAR**) "\0", 16);//ToDec (rValStr);//atoi ((TCHAR*) rValStr); //_itoa (convertedVal, (TCHAR*) rValStr, 10); UnitGroup* pPossibleUnits = SourceContext->GetComponentUnitGroup(1); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::SetComponentFromString - SourceContext has NULL units"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "ColourPicker::SetComponentFromString - pPossibleUnits aren't"); ScaleUnit* pUnit = pPossibleUnits->FindUnitFromIndex (1);//GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentAsString - Default units NULL"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "pUnits isn't"); double dNewVal; Convert::StringToDouble(rValStr, &dNewVal); pUnit->ConvertTo0to1 (dNewVal); // And set the new value returnVal = SetComponentFromDouble(Dest, SourceContext, 1, dNewVal); } if (gComponent == TRUE) // deal with the green component { No0xPrefixNewValue.Split (&gValStr, &No0xPrefixNewValue, 2, FALSE); INT32 convertedVal; camSscanf(gValStr, _T("%X"), &convertedVal); camSprintf(gValStr, _T("%d"), convertedVal); //INT32 convertedVal = (INT32) strtol ((TCHAR*) gValStr, (TCHAR**) "\0", 16);//ToDec (rValStr);//atoi ((TCHAR*) rValStr); //_itoa (convertedVal, (TCHAR*) gValStr, 10); UnitGroup* pPossibleUnits = SourceContext->GetComponentUnitGroup(2); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::SetComponentFromString - SourceContext has NULL units"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "ColourPicker::SetComponentFromString - pPossibleUnits aren't"); ScaleUnit* pUnit = pPossibleUnits->FindUnitFromIndex (1);//GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentAsString - Default units NULL"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "pUnits isn't"); double dNewVal; Convert::StringToDouble(gValStr, &dNewVal); pUnit->ConvertTo0to1 (dNewVal); // And set the new value returnVal = SetComponentFromDouble(Dest, SourceContext, 2, dNewVal); } if (bComponent == TRUE) // deal with the blue component { No0xPrefixNewValue.Split (&bValStr, &No0xPrefixNewValue, 2, FALSE); INT32 convertedVal; camSscanf(bValStr, _T("%X"), &convertedVal); camSprintf(bValStr, _T("%d"), convertedVal); //INT32 convertedVal = (INT32) strtol ((TCHAR*) bValStr, (TCHAR**) "\0", 16);//ToDec (rValStr);//atoi ((TCHAR*) rValStr); //_itoa (convertedVal, (TCHAR*) bValStr, 10); UnitGroup* pPossibleUnits = SourceContext->GetComponentUnitGroup(3); if (pPossibleUnits == NULL) { ERROR3("ColourPicker::SetComponentFromString - SourceContext has NULL units"); return FALSE; } ERROR3IF(!pPossibleUnits->IS_KIND_OF(UnitGroup), "ColourPicker::SetComponentFromString - pPossibleUnits aren't"); ScaleUnit* pUnit = pPossibleUnits->FindUnitFromIndex (1);//GetDefaultUnit(); if (pUnit == NULL) { ERROR3("ColourPicker::GetComponentAsString - Default units NULL"); return FALSE; } ERROR3IF(!pUnit->IS_KIND_OF(ScaleUnit), "pUnits isn't"); double dNewVal; Convert::StringToDouble(bValStr, &dNewVal); pUnit->ConvertTo0to1 (dNewVal); // And set the new value returnVal = SetComponentFromDouble(Dest, SourceContext, 3, dNewVal); } return (returnVal); } else { return (FALSE); // that don't look like hex to me! } }

void ColourPicker::SetFixedComponentGadgets (  CWindowID  WindowID, CGadgetID *  Gadgets, CGadgetID  PickerGadget, ColourModel  ModelToDisplay, INT32  TextWidth[], INT32  EditWidth[] )  [static, protected]

Private function used by the kernel ColourEditDlg editor. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> Date: 23/02/2004 Parameters: WindowID  - The DialogOp->WindowID member variable of the Dialogue [INPUTS] Gadgets - A NULL-terminated list of Gadget IDs of the gadgets to be moved/resized. There MUST be 8 gadget IDs, paired up into (name,writable) sets. PickerGadget - specifies the gadget under which the controls are spaced. If they can be fitted, they will maybe be centered under this control in order to look neater. ModelToDisplay - Indicates the model you're going to put into the controls This is used to determine how many components should be shown and stuff. This takes the 5 component names and component writable fields and spreads them out within the window to allow the names to go next to the writables. The name fileds are resized to fill the available spaces, so you should make them right-aligned to keep the text a set disatnce from the writable for all colour models. It's still up to you to set the contents of the controls, and hide any extra ones (so as much of this crap goes into the kernel as possible). This only changes the positions of the first NumComponents control-pairs. It also hides ALL of the windows. This means that while swapping models they go off and on, but it looks a lot better than the user seeing all the faffing arounf as they are moved, resized, and have their contents changed. Scope: private Definition at line 2742 of file colpick.cpp. { PORTNOTE("other", "Disabled ColourPicker::SetFixedComponentGadgets") #ifndef EXCLUDE_FROM_XARALX RECT TheRect; CWindowID hGadget; INT32 Left = 0; INT32 MaxWidth = 0; // if (NumComponents < 3) { // Use width of colour picker control hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)PickerGadget); if (hGadget && GetWindowRect(hGadget, &TheRect)) { // convert screen rect to client position within the parent wnd ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &TheRect, 2); MaxWidth = TheRect.right - TheRect.left; Left = TheRect.left; } } // Use width of the window // if (GetClientRect((CWindowID)WindowID, &TheRect)) // { // MaxWidth = TheRect.right - TheRect.left; // MaxWidth -= 2 * Left; // Left = 0; // } // if (MaxWidth < 1) // return; // // Find the top/bottom position for the text gadgets, in client coords RECT TextRect; hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[0]); if (hGadget == NULL || !GetWindowRect(hGadget, &TextRect)) return; ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &TextRect, 2); INT32 TextHeight = TextRect.bottom-TextRect.top; // Get the current position of the first Editable control RECT EditRect; hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[1]); GetWindowRect(hGadget, &EditRect); ::MapWindowPoints(NULL, (CWindowID)WindowID, (LPPOINT) &EditRect, 2); INT32 EditHeight = EditRect.bottom-EditRect.top; // For each component, place the controls INT32 LeftEnd = Left; INT32 i=0; const INT32 Gap = 4; // Min. gap between adjacent fields const INT32 LabelGap = 1; for (i = 0; i < 5; i++) { // Move and resize (in x axis only) the text gadget hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[i*2]); if (hGadget) { if (TextWidth[i]!=0) { SetWindowPos(hGadget, NULL, LeftEnd, TextRect.top, TextWidth[i], TextHeight, SWP_HIDEWINDOW | SWP_NOACTIVATE | SWP_NOZORDER | SWP_NOCOPYBITS | SWP_NOREDRAW); LeftEnd += TextWidth[i] + LabelGap; } else ShowWindow(hGadget, SW_HIDE); } // Move (in x axis only) the writable gadget hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[(i*2)+1]); if (hGadget) { if (EditWidth[i]!=0) { SetWindowPos(hGadget, NULL, LeftEnd, EditRect.top, EditWidth[i], EditHeight, SWP_HIDEWINDOW | SWP_NOACTIVATE | SWP_NOZORDER | SWP_NOCOPYBITS | SWP_NOREDRAW); LeftEnd += EditWidth[i] + Gap; } else ShowWindow(hGadget, SW_HIDE); } } // Finally, redraw the affected strip of the window, because the controls won't EditRect.left = 0; // Left edge of window EditRect.right = 0x1000; // Infinity as far as the window is concerned ::InvalidateRect((CWindowID)WindowID, &EditRect, TRUE); #endif }

void ColourPicker::SetGadgetPositions (  CWindowID  WindowID, CGadgetID *  Gadgets, CGadgetID  MoveUnder )  [static, protected]

Private function used by the kernel ColourEditDlg editor. Given a WindowID and GadgetIDs (cf DialogOp->DialogMgr interface), this moves all the gadgets such that (a) All the gadgets in the group remain in the same relative positions, and (b) the Gadgets[0] gadget is moved to lie just underneath the MoveUnder gadget. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 23/11/94 Parameters: WindowID  - The DialogOp->WindowID member variable of the Dialogue [INPUTS] Gadgets - A NULL-terminated list of Gadget IDs of the gadgets to be moved. The first entry in this list is the anchor gadget - it will be moved just under 'MoveUnder', and the others will stay in the same position relative to the first gadget in the list. MoveUnder - The gadget ID of the gadget under which all these gadgets should be positioned, or NULL to 'hide' the gadgets well off the window The X positions of the gadgets are unaffected by this call. If MoveUnder == NULL, then the gadgets are moved a large distance away so that they will not appear in the visible portion of the window. This is used to move tint/link options to the bottom of the editor window, while hiding the link/tint options gadgtes respectively. Scope: private Definition at line 2409 of file colpick.cpp. { PORTNOTE("other", "Disabled ColourPicker::SetGadgetPositions"); #ifndef EXCLUDE_FROM_XARALX if (Gadgets == NULL || !Gadgets[0]) return; CWindowID hGadget; RECT MoveRect; POINT TopLeft; INT32 YShift = 10000; // If MoveUnder == NULL, move out of the way if (MoveUnder) { // Get the positions of the MoveUnder and Gadgets[0] gadgets, and work out // the Y Shift to move Gadgets[0] just under the MoveUnder gadget. // All calculations are done in Client coords (not screen coords) hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)MoveUnder); if (!GetWindowRect(hGadget, &MoveRect)) return; TopLeft.x = MoveRect.left; TopLeft.y = MoveRect.bottom; ScreenToClient((CWindowID)WindowID, &TopLeft); YShift = -(TopLeft.y + 8); // Remember first part of the shift hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[0]); if (!GetWindowRect(hGadget, &MoveRect)) return; TopLeft.x = MoveRect.left; TopLeft.y = MoveRect.top; ScreenToClient((CWindowID)WindowID, &TopLeft); YShift += TopLeft.y; // Complete the shift calculation } else { // Move the gadgets out of view: Check if we need to bother to do this // (are they aready out of view?) hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[0]); if (!GetWindowRect(hGadget, &MoveRect)) return; TopLeft.x = MoveRect.left; TopLeft.y = MoveRect.top; ScreenToClient((CWindowID)WindowID, &TopLeft); if (abs(TopLeft.y) > 8000) // Is it already out of the way? YShift = 0; // Yes - so don't shift it } if (YShift == 0) // No shift needed! return; INT32 Index = 0; while (Gadgets[Index] != 0) { hGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)Gadgets[Index]); if (GetWindowRect(hGadget, &MoveRect)) { TopLeft.x = MoveRect.left; // Convert TopLeft coord into client coords TopLeft.y = MoveRect.top; ScreenToClient((CWindowID)WindowID, &TopLeft); TopLeft.y -= YShift; SetWindowPos(hGadget, NULL, TopLeft.x, TopLeft.y, 0, 0, SWP_NOACTIVATE | SWP_NOSIZE | SWP_NOZORDER); } Index++; } #endif }

BOOL ColourPicker::SetShadeFromStrings (  IndexedColour *  Dest, StringBase *  NewValueX, StringBase *  NewValueY )  [static, protected]

Assumes that the string will be -100..100 Clips the string value into a -1.0 to 1.0 in-gamut range, and then sets the shade components of the converted colour to those values. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 24/10/95 Parameters: Dest  - the colour to be set [INPUTS] NewValueX - new value (decimal, as -100..100) of the shade X component NewValueY - new value (decimal, as -100..100) of the shade Y component Dest  is updated appropriately [OUTPUTS] Returns: TRUE if the value was out of gamut and had to be clipped Notes: ENSUREs and does nothing if the colour is not already a Shade Scope: private See also: ColourPicker::GetShadeValueAsString Definition at line 2216 of file colpick.cpp. { ERROR3IF(Dest == NULL || NewValueX == NULL || NewValueY == NULL, "ColourPicker::SetShadeFromStrings - NULL Parameters are illegal"); if (Dest->GetType() != COLOURTYPE_TINT) { ERROR3("ColourPicker::SetShadeFromStrings - colour isn't a tint/shade"); return(FALSE); } // Turn all percent signs in the number to spaces so the StringToDouble doesn't yell and scream String_8 TempString; NewValueX->Left(&TempString, 7); TempString.SwapChar(_T('%'),_T(' ')); // Convert the string to a double using the global conversion routine // Note that we ignore failure, because the number is validated below, and it // only seems to retun false if crap was typed on the end of the number anyway double NewValX; Convert::StringToDouble(TempString, &NewValX); // Convert from percentage to -1.0-1.0 range NewValX = (-NewValX) / 100.0; BOOL OutOfGamut = FALSE; // Add half of the least-significant-bit-value to round the new value NewValX += 1.0 / ((double) (1<<25)); // Clip to lie within gamut if (NewValX < -1.0) { NewValX = -1.0; OutOfGamut = TRUE; } if (NewValX > 1.0) { NewValX = 1.0; OutOfGamut = TRUE; } // Turn all percent signs in the number to spaces so the StringToDouble doesn't yell and scream NewValueY->Left(&TempString, 7); TempString.SwapChar(_T('%'),_T(' ')); // Convert the string to a double using the global conversion routine // Note that we ignore failure, because the number is validated below, and it // only seems to retun false if crap was typed on the end of the number anyway double NewValY; Convert::StringToDouble(TempString, &NewValY); // Convert from percentage to -1.0-1.0 range NewValY /= 100.0; // Add half of the least-significant-bit-value to round the new value NewValY += 1.0 / ((double) (1<<25)); // Clip to lie within gamut if (NewValY < -1.0) { NewValY = -1.0; OutOfGamut = TRUE; } if (NewValY > 1.0) { NewValY = 1.0; OutOfGamut = TRUE; } Dest->SetShadeValues(FIXED24(NewValX), FIXED24(NewValY)); return(OutOfGamut); }

BOOL ColourPicker::SetTintFromString (  IndexedColour *  Dest, StringBase *  NewValue )  [static, protected]

Assumes that the string will be 0..100 Clips the string value into a 0.0 to 1.0 in-gamut range, and then sets the tint component of the converted colour to that value. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/95 Parameters: Dest  - the colour to be set [INPUTS] NewValue - new value (decimal, as 0..100) of the tint Dest  is updated appropriately [OUTPUTS] Returns: TRUE if the value was out of gamut and had to be clipped Notes: ENSUREs and does nothing if the colour is not already a Tint Scope: private See also: ColourPicker::GetTintAsString Definition at line 2058 of file colpick.cpp. { ERROR3IF(Dest == NULL || NewValue == NULL, "ColourPicker::SetTintFromString - NULL Parameters are illegal"); if (Dest->GetType() != COLOURTYPE_TINT) { ERROR3("ColourPicker::SetTintFromString - colour isn't a tint"); return(FALSE); } // Turn all percent signs in the number to spaces so the StringToDouble doesn't yell and scream String_8 TempString; NewValue->Left(&TempString, 7); TempString.SwapChar(_T('%'), _T(' ')); // Convert the string to a double using the global conversion routine // Note that we ignore failure, because the number is validated below, and it // only seems to retun false if crap was typed on the end of the number anyway double NewVal; Convert::StringToDouble(TempString, &NewVal); // Convert from percentage to 0.0-1.0 range NewVal /= 100.0; BOOL OutOfGamut = FALSE; // Add half of the least-significant-bit-value to round the new value NewVal += 1.0 / ((double) (1<<25)); // Clip to lie within gamut if (NewVal < 0.0) { NewVal = 0.0; OutOfGamut = TRUE; } if (NewVal > 1.0) { NewVal = 1.0; OutOfGamut = TRUE; } // And set the new value if (Dest->TintIsShade()) { // Dest->SetShadeValue(NewVal); } else Dest->SetTintValue(NewVal); return(OutOfGamut); }

void ColourPicker::SetWindowExtent (  CWindowID  WindowID, CGadgetID  XGadgetID, CGadgetID  YGadgetID )  [static, protected]

Private function used by the kernel ColourEditDlg editor. Given a WindowID and GadgetID (cf DialogOp->DialogMgr interface), this sets the window extent of the window to a short distance outside the right/ bottom edges of the X/Y named gadgets respectively. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 14/11/94 Parameters: WindowID  - The DialogOp->WindowID member variable of the Dialogue [INPUTS] XGadgetID - The Gadget ID of the gadget to be at the right side of the dlg YGadgetID - The Gadget ID of the gadget to be at the bottom of the dlg The colour editor uses this to 'fold' and 'unfold' its window to hide/show the advanced editing options. Scope: private Definition at line 2321 of file colpick.cpp. { PORTNOTE("other", "Disable Colourpicker::SetWindowExtent") #ifndef EXCLUDE_FROM_XARALX CWindowID hXGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)XGadgetID); CWindowID hYGadget = DialogManager::GetGadget((CWindowID)WindowID, (INT32)YGadgetID); RECT MainWinPos; RECT XGadgetPos; RECT YGadgetPos; BOOL ok = TRUE; // We can't use GetWindowRect() for the gadgets then use these values when adjusting // the values you get from GetWindowPlacement() for the main window, because they use two // different origins. // // Basically, using the above calls will result in errors if the task bar is at the top of the // screen, because one call uses the actual screen top-left coord, the other uses the top-ledt coord // of the desk top excluding the task bar. // // The method used here uses GetWindowRect() for all three gadgets to work out a relative difference // between the gadgets. It then uses GetWindowPosition() & SetWindowPosition() which work consistantly // because they use the same coord space. // Collect the screen positions of the three items if (ok) ok = GetWindowRect((CWindowID)WindowID,&MainWinPos); if (ok) ok = GetWindowRect(hXGadget,&XGadgetPos); if (ok) ok = GetWindowRect(hYGadget,&YGadgetPos); if (ok) { // dx & dy are calculated to be the amount we need to adjust the right & bottom of the // dlg to come in line with the two gadgets given INT32 dx = MainWinPos.right - XGadgetPos.right; INT32 dy = MainWinPos.bottom - YGadgetPos.bottom; // Get the window's screen position if (DialogManager::GetWindowPosition(WindowID, &MainWinPos)) { // Adjust it (with added help from a bodge value) MainWinPos.right -= dx - 6; MainWinPos.bottom -= dy - 6; // Set it back again DialogManager::SetWindowPosition(WindowID, MainWinPos); } } #endif }

void ColourPicker::UpdateBubbleHelpAndPointer (  void   )  [static]

Called on Idle (or MouseMove) events to provide bubble help and update the mouse pointer while it is over the colour editor dialogue. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 28/9/95 Notes: This is basically a bodge until a proper dialogue bubblehelp system is available to do everything I need to do in the colour editor. See also: ColourEditDlg::GetStatusLineText Definition at line 1050 of file colpick.cpp. { PORTNOTE("other", "Disabled ColourPicker::UpdateBubbleHelpAndPointer()") #ifndef EXCLUDE_FROM_XARALX #ifndef STANDALONE ColourEditDlg *Editor = ColourEditDlg::TheEditor; if (Editor == NULL) return; static CWindowID TheWindow = NULL; if (TheWindow == NULL) TheWindow = (CWindowID)Editor->WindowID; if (TheWindow == NULL) return; // We will update the bubble help every time we are called. However, we will only // bother checking through all the gadgets in the window a maximum of 10 times // per second. This stops the colour editor making a CPU interference buzzing noise // in my headphones while the pointer is idling over it!! static MonotonicTime LastUpdate; static UINT32 MousePos = 0; if (LastUpdate.Elapsed(100)) { // Remember when we last checked LastUpdate.Sample(); // Default to the mouse being "nowhere special" again TheWindow = (CWindowID)Editor->WindowID; MousePos = 0; POINT MouseScreenPos; if (::GetCursorPos(&MouseScreenPos)) { // Only continue processing if the window under the pointer is the colour editor // or a child thereof. My machine makes a funny CPU buzz in my earphones when the // pointer is in the editor window, and it was doing this even when I had another // application maximised in front of camelot! ChildWindowFromPoint does not // determine if the child window is actually *visible*! CWindowID WindowUnder = ::WindowFromPoint(MouseScreenPos); if (WindowUnder != NULL && (WindowUnder == TheWindow || ::GetParent(WindowUnder) == TheWindow)) { POINT TempPos; TempPos.x = MouseScreenPos.x; TempPos.y = MouseScreenPos.y; // Convert to client coords in the main window ::ScreenToClient(TheWindow, &TempPos); CPoint Pos(TempPos); CWindowID WindowUnderPointer = ::ChildWindowFromPoint(TheWindow, Pos); if (WindowUnderPointer != NULL && IsWindowVisible(WindowUnderPointer)) { // Make sure that hidden windows do not provide status help! INT32 WindowStyle = ::GetWindowLong(WindowUnderPointer, GWL_STYLE); if ((WindowStyle & WS_VISIBLE) != 0) { CWindowID hGadget; INT32 i = 0; while (GadgetList[i] && MousePos) { hGadget = DialogManager::GetGadget(TheWindow, GadgetList[i]); if (WindowUnderPointer == hGadget) { MousePos = (UINT32)GadgetList[i]; TheWindow = hGadget; } i++; } } } // Special check for Picker control (BODGE is a more accurate term!) // We look to see if the pointer is vaguely over the area of the picker used // to display the current/original colour patch, and only give help for that // region! if (MousePos == _R(IDC_EDIT_PICKER)) { MousePos =0; // Default to no help if anything goes wrong // Set up a ReDrawInfoType containing the click position info, and information // that will come in handy (size of the gadget, and screen DPI) ReDrawInfoType ExtraInfo; ExtraInfo.pDC = NULL; // No redraw info for mouse events ExtraInfo.pClipRect = NULL; // Get the screen DPI HDC ScreenDC = CreateCompatibleDC(NULL); if (ScreenDC == NULL) { ERROR3("ColourPicker: Unable to create screen DC"); return; } ExtraInfo.Dpi = GetDeviceCaps(ScreenDC, LOGPIXELSY); DeleteDC(ScreenDC); // Calculate how big the window is, in MILLIPOINTS RECT WindowSize; if (!GetClientRect(TheWindow, &WindowSize)) { ERROR3("GetClientRect failed in ColourPicker"); return; } ExtraInfo.dx = (((INT32)WindowSize.right)*72000) / ExtraInfo.Dpi; ExtraInfo.dy = (((INT32)WindowSize.bottom)*72000) / ExtraInfo.Dpi; // Work out the MILLIPOINT coordinates of the mouse position // Note that the Y value is flipped, as the kernel-origin is at the bottom left // and we have to first convert the screen mouse position into client coords ScreenToClient(TheWindow, &MouseScreenPos); INT32 XPos = (INT32) MouseScreenPos.x; INT32 YPos = (INT32) MouseScreenPos.y; DocCoord MouseInfo; MouseInfo.x = (XPos * 72000) / ExtraInfo.Dpi; MouseInfo.y = ExtraInfo.dy - ((YPos * 72000) / ExtraInfo.Dpi); ExtraInfo.pMousePos = &MouseInfo; // Now call the colour editor to handle the mouse position - it will // set the pointer shape as appropriate and also return us some bubble help. PickerBubbleBuffer = String_128(""); StatusHelpBuffer = String_256(""); Editor->HandleIdlePointer(&ExtraInfo, &PickerBubbleBuffer, &StatusHelpBuffer, &MousePos); if (MousePos) ControlHelper::BubbleHelpDisable(); // On non-helpful bit of picker - cancel bubble help } } } } // Finally, tell the bubble help system what help we want, if any if (MousePos) { // Set up our callback handler to show the help if/when necessary ControlHelper::DoBubbleHelpOn(TheWindow, MousePos, ColourPicker::HelpCallbackHandler, NULL); } #endif #endif }

---

Friends And Related Function Documentation

friend class ColourEditDlg [friend]

Definition at line 142 of file colpick.h.

friend class ColourLinkDlg [friend]

Definition at line 143 of file colpick.h.

friend class NewColourDlg [friend]

Definition at line 144 of file colpick.h.

---

Member Data Documentation

INT32 ColourPicker::s_IdleCounter = 0 [static, private]

Definition at line 266 of file colpick.h.

BOOL ColourPicker::s_InColourDialogLayout = FALSE [static, private]

Definition at line 264 of file colpick.h.

BOOL ColourPicker::s_JustCreated = FALSE [static, private]

Definition at line 265 of file colpick.h.

wxSize ColourPicker::s_LastSize = wxDefaultSize [static, private]

Definition at line 261 of file colpick.h.

wxSize ColourPicker::s_MinSize = wxSize(180,100) [static, private]

Definition at line 263 of file colpick.h.

wxSize ColourPicker::s_UserSize = wxSize(245,245) [static, private]

Definition at line 262 of file colpick.h.

---

The documentation for this class was generated from the following files:

• wxOil/colpick.h (r1785/r1282)
• wxOil/colpick.cpp (r1785/r1350)

---