Click or drag to resize

mcEditPasteAoiOptionFlags Enumeration

Flags for the McDisplay.EditPasteAoi OptionFlags argument.

Namespace:  MediaCy.IQL.Display.Viewer
Assembly:  MediaCy.IQL.Display.Viewer (in MediaCy.IQL.Display.Viewer.dll) Version: 10.0.6912.0
Syntax
VB
Public Enumeration mcEditPasteAoiOptionFlags
Members
  Member nameValueDescription
mcepaofUseSettings-1When given as the OptionFlags argument,then the EditPasteAoi options are determined from the settings saved by Application.CommandDialogs("Preferences").Pages("PasteOptions").
mcepaofDefault0No preview takes place, the paste isapplied without blending (i.e., always 100%), and the AOI after the paste is left unchanged (equivalent to the mcepaofAoiAfter_KeepDestUnchanged option).
mcepaofPreviewThePaste1If there is an OwningView, then aMcBlendTool is invoked on that McView to allow the user to position the pasting image. If there is no OwningView, then use of this flag is an error. In the default case (where OptionFlags are mcepaofDefault), then this flag is automatically turned off if there is no OwningView.
mcepaofPreviewWithBlend2During any user preview (see themcepaofPreviewThePaste flag) the clipboard image is shown with blending, using the BlendPercent and BlendOptionFlags. If this flag is not set, then during preview the clipboard image is shown with 100 percent intensity, and no luminance masking is done. But in any case, the BlendOptionFlags mvbsMaskBySourceAoi and mvbsMaskByDestAoi flags are always honored during preview.
mcepaofApplyWithBlend4During the actual apply of theclipboard image into the ImageToDisplay the clipboard image is blended with the ImageToDisplay, using the BlendPercent and BlendOptionFlags. If this flag is not set, then the clipboard image is pasted into the ImageToDisplay with 100 percent intensity, and no luminance masking is done. But in any case, the BlendOptionFlags mvbsMaskBySourceAoi and mvbsMaskByDestAoi flags are always honored during the paste.
mcepaofAoiAfter_PasteSrcAoi16After the paste is appliedto the ImageToDisplay, the aligned clipboard image's AOI is made the new AOI. If the clipboard image has no AOI, then a rectangular AOI encompasing its entire bounds is created.
mcepaofAoiAfter_KeepDestUnchanged32After the paste is appliedto the ImageToDisplay, the ImageToDisplay's AOI is left unchanged.
mcepaofAoiAfter_IntersectSrcAndDest48After the paste is appliedto the ImageToDisplay, the intersection between the ImageToDisplay's AOI and the aligned clipboard image's AOI is made the new AOI. If this intersection is empty, then there will be no ImageToDisplay AOI. If either the ImageToDisplay or the clipboard image has no AOI, then a rectangular AOI encompasing its entire bounds is created for use in creating the intersection.
mcepaofAoiAfter_ClearToNone64After the paste is appliedto the ImageToDisplay, the ImageToDisplay's AOI is cleared.
mcepaofAoiAfter_Mask112Mask for the themcepaofAoiAfter_... options. Only one of the mcepaofAoiAfter_... options may be set.
mcepaofDoNotApplyThePaste256If this flag is set, thenthe actual paste operation is not performed after the user completes the preview. Instead the preview McBlendTool is only started and it is the caller's responsibility to monitor when it ends and then take any further action. You would use this flag if you needed to perform some action after the user has set the paste position during the preview, but before the paste is done (e.g., to capture Undo information). Note that this flag makes no sense and is ignored unless a preview is being done. See the Remarks and Examples with the McDisplay.EditPasteAoi method for more information on how to monitor the McBlendTool completion.
Remarks
These flags (along with the BlendOptionFlags argument) control the technique used to merge an image the is in the clipboard with the ImageToDisplay. Except where noted, the flag values may be Or'ed together. However, only one of the mcepaofAoiAfter_... options may be set.
See Also