4D CAD 1.4.4 - 4D CAD Reference

Next: 4D CAD 1.4.3, Previous: 4D CAD 1.4.5, Up: 4D CAD releases

C.2.8 4D CAD 1.4.4

(553) Fixed problems detecting key modifiers on Mac PowerPC.
(554) Fixed problems using the Edit menu with plugins in 4Dv11.
(555) Renamed several functions that still had the old 4Dv3 name length limit, changing
- CADGetLTypeIDs to CADGetLineTypeIDs
- CADGetLTypeDef to CADGetLineTypeDefinition
- CADGetPrintSpec to CADGetPrintSpecs
- CADSetPrintSpec to CADSetPrintSpecs
- CADGetLayerAttr to CADGetLayerAttributes
- CADSetLayerAttr to CADSetLayerAttributes
- CADGetLayOrder to CADGetLayerOrder
- CADSetLayOrder to CADSetLayerOrder
- CADGetCurrLayer to CADGetCurrentLayer
- CADSetCurrLayer to CADSetCurrentLayer
- CADGetIDsArray to CADGetObjIDsArray
- CADGetType to CADGetObjType
- CADAddEllipsArc to CADAddEllipseArc
- CADObjEllipsArc to CADObjEllipseArc
- CADGetEllipsArc to CADGetEllipseArc
- CADSetEllipsArc to CADSetEllipseArc
- CADMetricsByMat to CADMetricsByMatrix
- CADCalcImageRes to CADCalcImageResolution
- CADCalcImageMat to CADCalcImageMatrix
- CADGetInsColor to CADGetInsertColor
- CADSetInsColor to CADSetInsertColor
- CADCopyAttribs to CADCopyAttributes
- CADCopyObjByMat to CADCopyObjByMatrix
- CADImageFileInf to CADGetImageFileInfo
- CADImageInfo to CADGetImageInfo
- CADDecimalDiff to CADDecimalDifference
- CADIdentityMat to CADIdentityMatrix
- CADStandardMat to CADStandardMatrix
- CADTranslateMat to CADTranslateMatrix
- CADRotateMat to CADRotateMatrix
- CADScaleMat to CADScaleMatrix
- CADMirrorMat to CADMirrorMatrix
- CADShearMat to CADShearMatrix
- CADTransformMat to CADTransformMatrix
- CADFlipMat to CADFlipMatrix
- CADStretchMat to CADStretchMatrix
- CADInvertMat to CADInvertMatrix
- CADCalcMat to CADCalcMatrix
- CADGetMatPlane to CADGetMatrixPlane .
(556) Migrated the text engine on Macintosh from QuickDraw to CoreGraphics. This implies that on Macintosh:
- texts look more professionally
- fonts that are incompatible with QuickDraw, no longer cause problems
- fonts are no longer synthesized. If there is no installed font for a bold, italic, condensed or extended style variation, then the style variation is ignored. The reason is that CoreGraphics doesn’t have Quickdraw’s built-in font synthesis feature.
Notes
- underlining is done through a custom algorithm, so that underlining on screen and on print look exactly the same
- kerning can be implemented on request
- font selection still uses the QuickDraw font scheme.
(557) Added a string editor in the form of an inline edit box. The edit box software includes the following edit operations:
- left-arrow key
- left-arrow key with option modifier
- left-arrow key with shift modifier
- left-arrow key with shift and option modifier
- right-arrow key
- right-arrow key with option modifier
- right-arrow key with shift modifier
- right-arrow key with shift and option modifier
- up-arrow key
- up-arrow key with shift modifier
- down-arrow key
- down-arrow key with shift modifier
- backspace key
- forward delete key
- return, tab and enter key
- escape key
- entering characters
- mouse click
- mouse click with shift modifier
- mouse click with drag
- mouse double-click
- mouse double-click with drag
- mouse triple-click
- clipboard cut
- clipboard copy
- clipboard paste
- clear
- single undo
- single redo
and the following features:
- auto-size edit box
- automatic horizontal scrolling
- intelligent selection changes
- optional rotation angle
- character filtering
- MacRoman character set
Not yet supported are the following edit operations:
- left-arrow key with Mac control modifier
- left-arrow key with Mac control and shift modifier
- right-arrow key with Mac control modifier
- right-arrow key with Mac control and shift modifier
- backspace key with option modifier
- forward delete key with option modifier
- mouse click with drag and the option modifier
- mouse click with drag-scroll
- mouse double-click with drag-scroll
- mouse double-click with drag and the option modifier
- multiple undo
- multiple redo
nor the following features:
- Unicode character set
- spelling checker
- context menus.
(558) To control the inline string editor, 4D CAD could be extended with:
- kCADObjLockString
- a preference setting for the appearance of an edit box (foreground, background, active and inactive hilite colors)
- a setting for to be filtered characters
- a setting for the characters that determine option-modifier selection boundaries
- a command to open and close the edit box
- a command to control the character selection in an edit box.
Please note that kCADUndoWriteString is still unimplemented.

(559) Added parameters to CADGetAreaPrefs and CADSetAreaPrefs that determine whether the application or the built-in string editor handles string editing:


      
            function CADGetAreaPrefs
                   (     theCADArea                    : longint;
                     var theWriteStringModeModifiers   : longint;
                     var theSpecialClickModeModifiers  : longint;
                     var theUseEditBoxForObjFlag       : integer;
                     var theUseEditBoxForNewObjFlag    : integer;
                     var theNoEditBoxModifiers         : longint): OSErr;
     
            function CADSetAreaPrefs
                   (     theCADArea                    : longint;
                         theWriteStringModeModifiers   : longint;
                         theSpecialClickModeModifiers  : longint;
                         theUseEditBoxForObjFlag       : integer;
                         theUseEditBoxForNewObjFlag    : integer;
                         theNoEditBoxModifiers         : longint): OSErr;

parameter theUseEditBoxForObjFlag (default kCADTrue ) is kCADTrue if the inline string-editor handles existing string objects
parameter theUseEditBoxForNewObjFlag (default kCADTrue) is kCADTrue if the inline string-editor handles new string objects
parameter theNoEditBoxModifiers (default 0) is the optional keyboard modifier that overrules theUseEditBoxForObjFlag and theUseEditBoxForNewObjFlag to let the application handle string editing.

For example, if theUseEditBoxForObjFlag and theUseEditBoxForNewObjFlag are set to kCADTrue, and theNoEditBoxModifiers is set to kCADModifierOptionKey , then a plain mouse click in mode kCADModeWriteString will show the inline string editor but a mouse click with the option modifier key will trigger an application dialog box (see below).

(560) Added a kCADEventPhaseBefore and kCADEventPhaseAfter phase to kCADEventIDWriteString .

In kCADModeWriteString, preference settings of CADSetAreaPrefs determine whether string editing is handled by the application or by the built-in string editor (see above).

If string editing is to be handled by the application, then a mouse click triggers a kCADEventPhaseDuring phase of kCADEventIDWriteString.

If string-editing is handled by the built-in string editor, then the following events are triggered instead:

kCADEventPhaseBefore phase when the string edit-box is about to be displayed
kCADEventPhaseAfter phase when the string edit-box is canceled or accepted.


      
         kCADEventPhaseBefore
     
         IO  Parameter         Type      Description
         in  theCADArea        longint   Area ID
         in  theEventID        longint   kCADEventIDWriteString
         in  theEventPhase     longint   kCADEventPhaseBefore
         in  theEventData1     longint   the Object ID of the string object
         in  theEventData2     longint   kCADTrue is the string object is a new object, kCADFalse if
                                         not
         in  theEventData3     longint   0
         in  theEventData4     longint   0
         in  theMouseX         real      Mouse X-coordinate, optionally snapped
         in  theMouseY         real      Mouse Y-coordinate, optionally snapped
         in  theEventValue1    real      Unsnapped mouse X-coordinate
         in  theEventValue2    real      Unsnapped mouse Y-coordinate
         in  theKeyAsciiValue  integer   0
         in  theModifiers      longint   Sum of pressed modifier keys, see modifier key constants
                                         (also see CADGetAreaPrefs and CADSetAreaPrefs)
         in  theTickCount      longint   Tick count of the system software (a tick is a 1/60th of a
                                         second)
         out theEventResult    longint   Set to kCADEventResultDoFilter to filter out the event or to
                                         kCADEventResultDontFilter to let it pass.
     
         kCADEventPhaseDuring
     
         IO  Parameter         Type      Description
         in  theCADArea        longint   Area ID
         in  theEventID        longint   kCADEventIDWriteString
         in  theEventPhase     longint   kCADEventPhaseDuring
         in  theEventData1     longint   Current Layer or Sublayer ID
         in  theEventData2     longint   0
         in  theEventData3     longint   kCADTrue if the mouse coordinate was snapped, kCADFalse if
                                         not
         in  theEventData4     longint   Target object scope, initially empty. If you add objects to
                                         this scope, they will be removed by a successive undo action
         in  theMouseX         real      Mouse X-coordinate, optionally snapped
         in  theMouseY         real      Mouse Y-coordinate, optionally snapped
         in  theEventValue1    real      Unsnapped mouse X-coordinate
         in  theEventValue2    real      Unsnapped mouse Y-coordinate
         in  theKeyAsciiValue  integer   0
         in  theModifiers      longint   Sum of pressed modifier keys, see Modifier key constants
                                         (also see CADGetAreaPrefs and CADSetAreaPrefs)
         in  theTickCount      longint   Tick count of the system software (a tick is a 1/60th of a
                                         second)
         out theEventResult    longint   Set to kCADEventResultTriggerUndoRedo to trigger an undo and
                                         redo. Set to kCADEventResultTriggerUndoOnly to trigger an
                                         undo only. Set to kCADEventResultTriggerNoUndo to trigger no
                                         undos. The default undo action removes those objects that
                                         were added to the target object scope.
     
         kCADEventPhaseAfter
     
         IO  Parameter         Type      Description
         in  theCADArea        longint   Area ID
         in  theEventID        longint   kCADEventIDWriteString
         in  theEventPhase     longint   kCADEventPhaseAfter
         in  theEventData1     longint   the Object ID of the string object
         in  theEventData2     longint   kCADTrue is the string object is a new object, kCADFalse if
                                         not
         in  theEventData3     longint   kCADTrue if the edit-box was accepted, kCADFalse if it was
                                         canceled
         in  theEventData4     longint   0
         in  theMouseX         real      0.0
         in  theMouseY         real      0.0
         in  theEventValue1    real      0.0
         in  theEventValue2    real      0.0
         in  theKeyAsciiValue  integer   0
         in  theModifiers      longint   0
         in  theTickCount      longint   0
         out theEventResult    longint   Don’t change.

(561) Renamed kCADEventFilter2CreateString to kCADEventFilter2WriteString .

(562) Added function CADPrintToPDF , as follows


      
          function CADPrintToPDF
                 (     theCADArea                    : longint;
                       thePDFEngine                  : integer;
                       thePDFFlags                   : longint;
                       theOptionalMacFileCreator     : Str4;
                       theMacVolumeRef               : integer;
                       theMacDirID                   : longint;
                       theDosDirPathStr              : Str255;
                       theFilename                   : Str255;
                       theReplaceExistingFileFlag    : integer;
                       thePDFTitleStr                : Str255;
                       thePDFAuthorStr               : Str255;
                       thePDFCreatorStr              : Str255): OSErr;

Only kCADPDFEngineAppleOSX is implemented. This implies that for now

CADPrintToPDF only works on Mac OS X
parameters thePDFTitleStr, thePDFAuthorStr and thePDFCreatorStr are ignored.