AIEPSRenderRegion Class Reference

A render region for exporting EPS files in Adobe Illustrator 7.0 EPS format. More...

#include <ai_epsrr.h>

Inheritance diagram for AIEPSRenderRegion:

List of all members.

Public Member Functions
	AIEPSRenderRegion (DocRect ClipRect, Matrix ConvertMatrix, FIXED16 ViewScale)
	Create and initialise a render region for exporting AI EPS. Sets up the string to put in the %Creator comment.
	~AIEPSRenderRegion ()
BOOL	ExportBitmap (NodeBitmap *pNodeBMP)
	Kicks off the NodeBitmap export process..
BOOL	ExportBevel (NodeBevel *pBevel)
	Renders a bevel into a DIB, and exports this as a bitmap to the AI file.
BOOL	ExportShadow (OILBitmap *pBitmap, UINT32 Darkness, DocRect &Bounds)
	Renders a shadow into a DIB, and exports this as a bitmap to the AI file.
BOOL	ExportLayer (Layer *pLayer)
	If there is an existing layer, it writes the end of layer tags, before creating a new layer record.
BOOL	StartLayer (Layer *pLayer)
	Writes a layer record to the file.
virtual BOOL	RenderChar (WCHAR ch, Matrix *pMatrix)
	Overrides the default behaviour for rendering a single character. Used to store additional information on text blocks needed for AI text. i.e. the overflow text block ((xxxxxxxxx) TX) which occurs after the unjustified ((x) Tx (x) Tx ) block. Both of these are needed for correct Illustrator export of text.
BOOL	ExportingOnPath ()
	To determine whether this text is being exported on a path.
virtual void	OverflowTextStart ()
	Start the overflow text block.
virtual void	OverflowTextFinish ()
	Finish the overflow text block and write both blocks to the actual EPS file.
BOOL	WriteMask (Path *MaskPath, BOOL OutputGroupToken=FALSE)
	Creates a path that defines a masking pattern. All successive paths (until the end of mask operator) will be clipped to this shape.
virtual void	SetClipRegion (ClipRegionAttribute *pClipAttr, BOOL Temp)
	The Adobe Illustrator version of Karim's EPSRenderRegion::SetClipRegion, This was needed as Illustrator uses non-standard EPS commands.
virtual void	RestoreClipRegion (ClipRegionAttribute *pClipAttr, BOOL Temp)
	Adobe Illustrator version of Karim's EPSRenderRegion::RestoreClipRegion. See SetClipRegion for why this was necessary.
virtual void	SetTextAsShapes (BOOL shapes)
	Sets the export TextAsShapes flag.
virtual BOOL	GetTextAsShapes ()
	Sets the export TextAsShapes flag.
virtual BOOL	IsGradientFillValidForExport (FillGeometryAttribute *pFill)
	Determines whether a particular fill can be used through the AI export See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage.
virtual void	IncludeGradientFill (FillGeometryAttribute *pFill, EFFECTTYPE effect)
	Stores information about a fill so that the same fill isn't declared multiple times. See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage, AIEPSRenderRegion::FindGradientInCache.
Protected Member Functions
virtual void	Initialise ()
	Sets up render region - it outputs the AIEPS file header comments, and intialises the rendering attributes.
virtual BOOL	WriteEPSVersion ()
	Writes the relevant EPS version declaration.
virtual BOOL	WriteEPSProcessColours ()
	Writes the colour type used to disk.
virtual BOOL	WriteEPSResources (EPSFilter *pFilter, Document *pDocument)
	This function writes out the resource inclusion string required for the AI file.
virtual BOOL	WriteEPSProlog (EPSFilter *pFilter, Document *pDocument)
	This method writes out the initialisation code for the included resources.
virtual void	OutputFillColour (void)
	If the fill is a gradient fill, this method will invoke the WriteGradientFillInstance method, otherwise it will call the base EPSRenderRegion OutputFillColour method. This allows Camelot to support gradient fills in the AI file format.
virtual BOOL	WriteGradientFills (Document *pDocument)
	Parses through the tree, identifies any gradient fills, and writes them to the export DC's file.
virtual BOOL	WriteDocumentSetup (Document *pDocument, EPSFilter *pFilter)
	Browse through the tree, and if a text story is found invoke the document setup function. By only exporting the font setup when necessary, the file size produced is smaller (which makes it easier for me to interpret :) ), and it should hopefully make the filter run a bit faster too.
virtual BOOL	EndLayer (void)
	If there is an existing layer, it writes the end of layer tags, before creating a new layer record.
virtual void	OutputWindingRule ()
	Output the winding rule used to AI EPS.
virtual void	OutputStrokeColour ()
	Output the current stroke colour. This function will use one of the following EPS tokens K - if not separating and colour is unnamed X - if not separating and colour is named G - if separating.
virtual void	OutputLineWidth ()
	Output the standard line width token and measure for AI EPS.
virtual void	OutputJoinType ()
	Output the standard AI EPS join type.
virtual void	OutputDashPattern ()
	Outputs EPS dash pattern values. This function currently only exists so that extra handling can be easily achieved for Illustrator EPS export of dash patterns in the future (if need be).
virtual void	OutputStartCap ()
	Output the start cap setting using the usual 'J' EPS token.
virtual void	OutputMitreLimit ()
	Output the current mitre limit value using the usual 'M' EPS token. Again, this is only here so that the AI export can be easily expanded or modified.
virtual void	OutputFontName ()
	Output an Illustrator format fontname and pointsize token. The format is /_fontname[-Bold|-Italic|-BoldItalic] pointsize Tf. EncodeFontName will generate this format from an internal fontname. DocodeFontName will return an internal format fontname and flags where nec.
virtual void	OutputTextRenderMode ()
	Output the change in the text's Render Mode (Tr) - this happens when the text's fill or line colour changes to or from blank, see-through colour.
virtual void	OutputTextAspectRatio ()
	Output the change in the text's aspect ratio (Tz).
virtual void	OutputTextTracking ()
	Output the change in the tracking (Tt).
virtual void	OutputTextJustification ()
	Output the change in the text justification (Ta).
virtual void	OutputTextLineSpacing ()
	Output the change in the line spacing (Tl).
virtual void	OutputTextBaselineShift ()
	Output the change in Baseline shift (Ts).
virtual void	OutputTextSubSuperScript ()
	Output the change in the Sub/Super script attribute (Ts).
virtual void	OutputFillRGBColour ()
	Writes additional info to the file for RGB fill colours See also: EPSRenderRegion::OutputFillRGBColour.
virtual void	OutputFillCMYKColour ()
	Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour.
virtual void	OutputStrokeRGBColour ()
	Writes additional info to the file for RGB stroke colours See also: EPSRenderRegion::OutputStrokeRGBColour.
virtual void	OutputStrokeCMYKColour ()
	Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour.
virtual void	OverflowTextStartGap ()
	Starts a new gap in the Overflow text, so that attributes can be written into the overflow blocks (the TX ones).
virtual void	OverflowTextFinishGap ()
	Closes a gap for writing attributes in the overflow text, so that a new line of overflow text can be started.
virtual void	OverflowTextWrite (TCHAR *text)
	Write some text to the overflow body file. This will store all the text and modified attributes for the TX text block.
virtual void	OverflowTextWriteSingleColour (UINT32 n)
	Output a colour value to the overflow text file. A 'single colour' is a value as used in the Camelot 'Colour' class, i.e. in the range 0 to 255. This range is converted to the range 0.0 to 1.0, and output to the file.
virtual void	OverflowTextWriteColour (PColourCMYK *)
	Output a colour, as expressed by the Camelot 'Colour' class. This function takes the CMYK variation, is this is most appropriate to EPS files. Camelot colour values are converted from the 0-255 range to the 0.0-1.0 range before being output.
virtual void	OverflowTextWriteNamedColour (DocColour *, ColourContext *pContext=NULL)
	Similar to OutputColour(), except it outputs the colour name and tint of the colour as well. If pCol does not reference an indexed colour, then the name "NoName" is used.
virtual void	OverflowTextWriteColourName (DocColour *pCol)
	Outputs a named colour's name as a string. If pCol does not reference an indexed colour, then the name "NoName" is used. This was seperated from OutputNamedColour so that the DeviceContext will not need to worry about which ColourModel to use (CMYK, RGB, etc...), as this will be determined by the RenderRegion.
virtual BOOL	RenderCharAsShape (WCHAR ch, Matrix *pMatrix)
	Allows text to be drawn as shapes, not characters, so that AI can cope with gradient filled text.
virtual BOOL	WriteNewLine (void)
	Writes a new line to the output of text if text is exported as characters, does nothing if it's exported as shapes.
Private Member Functions
virtual void	BuildGradientCache (Node *pStartNode)
	Builds up a 'cache' of gradient fills.
virtual void	BuildGradientCacheUsingScanner (Node *pNode, AIEPSGradientScanRenderRegion *pScan)
	Builds up the gradient cache by scanning through each node under pNode for new fills.
virtual void	WriteGradientCount ()
	Writes out the count of all the gradient fills in the Cache.
virtual void	WriteGradientDefinitions ()
	Writes out the definitions of all the gradient fills in the Cache.
virtual void	ClearGradientCache ()
	Deletes the list of stored gradient fills, that was built up using IncludeGradientFill.
virtual INT32	FindGradientInCache (FillGeometryAttribute *pFill, EFFECTTYPE effect)
	Deletes the list of stored gradient fills, that was built up using IncludeGradientFill.
BOOL	WriteLinearFill (FillGeometryAttribute *pFill, EFFECTTYPE effect, INT32 id)
	Writes a linear fill to the disk file.
BOOL	WriteRadialFill (FillGeometryAttribute *pFill, EFFECTTYPE effect, INT32 id)
	Writes a Radial fill to the disk file.
virtual void	WriteGradientFillInstance ()
	This function identifies whether or not the current fill is a gradient fill, and writes in the appropriate values if it is. I've already created the records of the gradients themselves (see above), so this is just a case of matching the gradient with its ID, and Adobe Illustrator can then put the records together.
BOOL	WriteGradientEntry (DocColour *pColour, INT32 Position, INT32 Midpoint)
	Writes a line into the definition of a gradient fill.
BOOL	WriteFillEffectSteps (DocColour *pColour1, INT32 pos1, DocColour *pColour2, INT32 pos2, INT32 bias, EFFECTTYPE effect)
	Writes the additional entries required for a special fill effect (rainbow or alt-rainbow) to the gradient definition, as a series of steps. See Also: AIEPSRenderRegion::WriteGradientEntry AIEPSRenderRegion::WriteLinearFill AIEPSRenderRegion::WriteRadialFill.
BOOL	LoadBitmapMatrix (NodeBitmap *pNodeBMP)
	This code generates a matrix to position and manipulate a bitmap within an AI file. Roughly, it calculates the angle of rotation, followed by the skew angle, and creates a matrix using these values. See Also: FlashExportDC::WriteBitmapFill ().
BOOL	LoadTranslationMatrix (DocCoord &Translation)
	Loads the matrix with:.
BOOL	WriteLoadedMatrix (void)
	Writes a pre-loaded matrix to the file. I've added a couple of functions to create a matrix first, since it'll be more efficient to store the data, and re-write it as required, than to recalculate it twice.
BOOL	WriteMaskTags (void)
	Writes out the tags at the end of each block of a mask's definition.
BOOL	WriteBitmapRecord (OILBitmap *pBitmap)
	Creates a kernel bitmap instance within the AI file.
BOOL	WriteBitmapHeader (INT32 Width, INT32 Height)
	Writes the AI header for a bitmap record.
BOOL	WriteBitmapBody (OILBitmap *pBitmap, INT32 Width, INT32 Height)
	Writes the bitmap's data to the file.
BOOL	WriteContoneBody (OILBitmap *pBitmap)
	Writes a contone bitmap to the file as a 32bpp image.
BOOL	WriteBitmapTail (void)
	Wraps up the bitmap instance.
Private Attributes
ListFill *	m_pLinearGradList
ListFill *	m_pRadialGradList
double	m_a
double	m_b
double	m_c
double	m_d
DocCoord	m_T
BOOL	m_ActiveLayer
UINT32	m_LayerColour
FILE *	m_fpOverflowText
BOOL	m_bInTextGap
BOOL	m_bTextAsShapes
Friends
class	AIEPSGradientScanRenderRegion

---

Detailed Description

A render region for exporting EPS files in Adobe Illustrator 7.0 EPS format.

Author:

Tim_Browse (Xara Group Ltd) <camelotdev@xara.com>, extended by Graeme

Date:

08/03/94

See also:

EPSRenderRegion

Definition at line 207 of file ai_epsrr.h.

---

Constructor & Destructor Documentation

AIEPSRenderRegion::AIEPSRenderRegion (  DocRect  ClipRect, Matrix  ConvertMatrix, FIXED16  ViewScale )

Create and initialise a render region for exporting AI EPS. Sets up the string to put in the %Creator comment. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 29/3/00 See also: EPSRenderRegion::EPSRenderRegion () Definition at line 145 of file ai_epsrr.cpp. : EPSRenderRegion ( ClipRect, ConvertMatrix, ViewScale ) { // Set up member variables. m_a = 1; m_b = 0; m_c = 0; m_d = 1; m_T = DocCoord ( 0, 0 ); m_ActiveLayer = FALSE; m_LayerColour = 0; m_fpOverflowText = NULL; m_bInTextGap = FALSE; m_bTextAsShapes = FALSE; m_pLinearGradList = NULL; m_pRadialGradList = NULL; // Initialise the creator string to show that it's an AI file. CreatorString = _T("Adobe Illustrator(TM) 7.0 by Xara."); }

AIEPSRenderRegion::~AIEPSRenderRegion (   )

Definition at line 181 of file ai_epsrr.cpp. { ClearGradientCache (); }

---

Member Function Documentation

void AIEPSRenderRegion::BuildGradientCache (  Node *  pStartNode  )  [private, virtual]

Builds up a 'cache' of gradient fills. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 20/3/2001 Parameters: pStartNode  - the node to start looking from. [INPUTS] See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientDefinitions Definition at line 3601 of file ai_epsrr.cpp. { // Node * pChild = NULL; // Set up the gradient searching system AIEPSGradientScanRenderRegion scanRR (this); scanRR.AttachDevice (DocView::GetSelected (), RenderDC, RenderView->GetDoc()->FindFirstSpread ()); scanRR.InitDevice (); // Although the counting system does return the number of fills found, it can be got from // the scanner just as easily. BuildGradientCacheUsingScanner (pStartNode, &scanRR); }

void AIEPSRenderRegion::BuildGradientCacheUsingScanner (  Node *  pNode, AIEPSGradientScanRenderRegion *  pScan )  [private, virtual]

Builds up the gradient cache by scanning through each node under pNode for new fills. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 20/3/2001 Parameters: pNode  - the node to start looking from. [INPUTS] pScan - the scanner to use See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientDefinitions Definition at line 3631 of file ai_epsrr.cpp. { // Children are rendered first, so that attributes will be applied to the right objects. Node * pChild = pNode->FindFirstChild (); while (pChild!=NULL) { BuildGradientCacheUsingScanner (pChild, pScan); pChild = pChild->FindNext (); } // "Render" the node into the scanner. Currently, rendering is the only way to access // the intermediate steps (and their attributes) in blends, contours and some others, // so we need to use a special Render Region to catch the gradient (fill) information. // // NOTE: Since this uses the same system as the main render loop, it shouldn't be possible // for the gradient cache and the main file to become out of sync. Also, bevels and // shadows are excluded, as they are rendered as bitmaps in AI export. if (!pNode->IsABevel () && !pNode->IsAShadow ()) pNode->Render (pScan); }

void AIEPSRenderRegion::ClearGradientCache (   )  [private, virtual]

Deletes the list of stored gradient fills, that was built up using IncludeGradientFill. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 30/3/2001 See also: AIEPSRenderRegion::IncludeGradientFill, AIEPSRenderRegion::FindGradientInCache Definition at line 3495 of file ai_epsrr.cpp. { ListFill * pList = NULL; // only clear it if there is a list to clear if (m_pLinearGradList) { // Cycle through the linear list deleting each item in turn. while (m_pLinearGradList != NULL) { pList = m_pLinearGradList->pNext; delete m_pLinearGradList; m_pLinearGradList = pList; } } if (m_pRadialGradList) { // Cycle through the radial list deleting each item in turn. while (m_pRadialGradList != NULL) { pList = m_pRadialGradList->pNext; delete m_pRadialGradList; m_pRadialGradList = pList; } } }

BOOL AIEPSRenderRegion::EndLayer (  void   )  [protected, virtual]

If there is an existing layer, it writes the end of layer tags, before creating a new layer record. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: -  [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIEPSRenderRegion::ExportLayer () Reimplemented from EPSRenderRegion. Definition at line 1219 of file ai_epsrr.cpp. { // Only act if there's an active layer. if ( m_ActiveLayer ) { // Cast the RenderDC pointer into a useful form. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Write out the end of layer tag. pDC->OutputToken ( _T("LB") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_EndLayer") ); pDC->OutputNewLine (); // Set m_ActiveLayer to be FALSE. m_ActiveLayer = FALSE; } return TRUE; }

BOOL AIEPSRenderRegion::ExportBevel (  NodeBevel *  pBevel  )

Renders a bevel into a DIB, and exports this as a bitmap to the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 6/4/00 Parameters: pBevel  - A pointer to a bevel node. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: NodeBevel::ExportRender Definition at line 228 of file ai_epsrr.cpp. { // Set up the local variables. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); RangeControl ControlFlags ( TRUE, TRUE ); Range ToRender ( pBevel, pBevel, ControlFlags ); KernelBitmap *pBitmap = NULL; Path *pSourcePath = &( pBevel->InkPath ); DocRect Bounds = pBevel->GetBoundingRect (); DocCoord Position ( Bounds.lo.x, Bounds.hi.y ); double Width = static_cast<double> ( Bounds.Width () ); double Height = static_cast<double> ( Bounds.Height () ); // Create and render the bitmap. pBitmap = pBevel->CreateBitmapCopy(-1.0,FALSE); if(!pBitmap) return FALSE; // Get the width and height of the bitmap. double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); // Write the path. (ChrisG 16/01/01) If we have one. if (pSourcePath->GetNumCoords () != 0) { WriteMask ( pSourcePath, TRUE ); } // Set up the bitmap translation matrix. LoadTranslationMatrix ( Position ); // Scale width and height to be valid value for AI co-ordinates. Width /= 1000; Height /= 1000; // And calcuate the scale values for placing the bitmap. m_a = Width / BMPWidth; m_d = Height / BMPHeight; // Write the bitmap record. WriteBitmapRecord ( pBitmap->ActualBitmap ); // Write the end of mask operator. (ChrisG 16/01/01) If we've written a mask. if (pSourcePath->GetNumCoords () != 0) { pDC->OutputToken ( _T("Q") ); pDC->OutputNewLine (); } if(pBitmap) { pBitmap->DestroyGreyscaleVersion(); delete pBitmap; } // Success! return TRUE; }

BOOL AIEPSRenderRegion::ExportBitmap (  NodeBitmap *  pNodeBMP  )

Kicks off the NodeBitmap export process.. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 31/3/00 Parameters: pNodeBMP  - A pointer to the NodeBitmap being exported. [INPUTS] Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 200 of file ai_epsrr.cpp. { // Set up the local variables. KernelBitmap *pBitmap = pNodeBMP->GetBitmap (); // Set up the bitmap's transformation matrix. LoadBitmapMatrix ( pNodeBMP ); // Write out the bitmap record. WriteBitmapRecord ( pBitmap->GetActualBitmap () ); return TRUE; }

BOOL AIEPSRenderRegion::ExportingOnPath (   )

To determine whether this text is being exported on a path. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/00 Returns: TRUE - yes, we are exporting on a path FALSE - no, we aren't exporting on a path See also: Definition at line 2578 of file ai_epsrr.cpp. { if (m_fpOverflowText) return TRUE; else return FALSE; }

BOOL AIEPSRenderRegion::ExportLayer (  Layer *  pLayer  )

If there is an existing layer, it writes the end of layer tags, before creating a new layer record. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: pLayer  - A pointer to a layer object. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIEPSRenderRegion::EndLayer () Definition at line 358 of file ai_epsrr.cpp. { // Tidy up the existing layer, if it exists. EndLayer (); // And write out the next layer. return StartLayer ( static_cast<Layer*> ( pLayer->FindNext ( CC_RUNTIME_CLASS ( Layer ) ) ) ); }

BOOL AIEPSRenderRegion::ExportShadow (  OILBitmap *  pBitmap, UINT32  Darkness, DocRect &  Bounds )

Renders a shadow into a DIB, and exports this as a bitmap to the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: pShadow  - A pointer to a shadow node. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: NodeBevel::ExportRender Definition at line 304 of file ai_epsrr.cpp. { // Set up the local variables. // KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); DocCoord Position ( Bounds.lo.x, Bounds.hi.y ); double Width = static_cast<double> ( Bounds.Width () ) / 1000; double Height = static_cast<double> ( Bounds.Height () ) / 1000; double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); DocColour ShadowColour = *( static_cast<FillGeometryAttribute*> ( GetCurrentAttribute ( ATTR_FILLGEOMETRY ) ) ->GetStartColour () ); DocColour BlendedShadow = AlphaBlend ( ShadowColour, mBackgroundColour, Darkness ); // And use the shadow colour to build a contone bitmap palette. pBitmap->BuildContonePalette ( BlendedShadow, mBackgroundColour, EFFECT_RGB, RenderView ); // Set up the bitmap translation matrix. LoadTranslationMatrix ( Position ); // And calcuate the scale values for placing the bitmap. m_a = Width / BMPWidth; m_d = Height / BMPHeight; // Write out the bitmap header. WriteBitmapHeader ( (INT32)BMPWidth, (INT32)BMPHeight ); // Export the bitmap. WriteContoneBody ( pBitmap ); // Finish off the bitmap record. WriteBitmapTail (); return TRUE; }

INT32 AIEPSRenderRegion::FindGradientInCache (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect )  [private, virtual]

Deletes the list of stored gradient fills, that was built up using IncludeGradientFill. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 30/3/2001 Returns the identifier of the found gradient fill, or 0 if it wasn't found See also: AIEPSRenderRegion::IncludeGradientFill, Definition at line 3538 of file ai_epsrr.cpp. { INT32 id = 0; ListFill * pList = NULL; FillGeometryAttribute * pStoredFill = NULL; double fillBias = 0; CProfileBiasGain fillProfile = pFill->GetProfile (); fillBias = (double) fillProfile.GetBias (); // work out which list we want to search in. if (pFill->IsARadialFill () || pFill->IsASquareFill ()) pList = m_pRadialGradList; else pList = m_pLinearGradList; // Cycle through all the fills until we find the one we want, or until we run out of fills while ((pList != NULL) && (id == 0)) { pStoredFill = pList->pFill; // Because the start and end points for an Illustrator fill are not included in the // cache, we don't need to worry about them being the same. // // So, we set all the start and end points to be the same (since they would cause two // identical fills in different places, or of different lengths to be considered as // different otherwise). pStoredFill->SetStartPoint (pFill->GetStartPoint ()); pStoredFill->SetEndPoint (pFill->GetEndPoint ()); pStoredFill->SetEndPoint2 (pFill->GetEndPoint2 ()); pStoredFill->SetEndPoint3 (pFill->GetEndPoint3 ()); // Now that the fill coords are the same, test to see whether they're // the same fill, or not. if (*pStoredFill == *pFill) { double storeBias = 0; CProfileBiasGain storeProfile = pStoredFill->GetProfile (); storeBias = (double) storeProfile.GetBias (); if ((storeBias == fillBias) && (pList->effect == effect)) id = pList->id; } // Check the next fill pList = pList->pNext; } return id; }

BOOL AIEPSRenderRegion::GetTextAsShapes (   )  [virtual]

Sets the export TextAsShapes flag. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 8th November 2000 Returns: BOOL - whether text is exported as shapes (TRUE) or characters (FALSE) See also: AIEPSRenderRegion::GetTextAsShapes Definition at line 3036 of file ai_epsrr.cpp. { return m_bTextAsShapes; }

void AIEPSRenderRegion::IncludeGradientFill (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect )  [virtual]

Stores information about a fill so that the same fill isn't declared multiple times. See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage, AIEPSRenderRegion::FindGradientInCache. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 5/2/2001 Definition at line 3416 of file ai_epsrr.cpp. { ERROR3IF ((pFill == NULL), "AIEPSRenderRegion::IncludeGradientFill - Attempted to include NULL fill"); ListFill * pNewList = NULL; FillGeometryAttribute * pNewFill = NULL; // don't try and store the fill if it's invalid. if (pFill != NULL) { // Create a new FillGeometryAttribute, of the same type as the one passed in. // NOTE: Four colour fills are derived from three colour fills, so they return // TRUE for IsAThreeColFill. This means that we need to process four colour // fills before we process three colour fills, otherwise all four colour fills // will become represented by three colour ones and the copy won't match the // original. if (pFill->IsALinearFill ()) pNewFill = new LinearFillAttribute; else if (pFill->IsARadialFill ()) pNewFill = new RadialFillAttribute; else if (pFill->IsAConicalFill ()) pNewFill = new ConicalFillAttribute; else if (pFill->IsASquareFill ()) pNewFill = new SquareFillAttribute; else if (pFill->IsAFourColFill ()) pNewFill = new FourColFillAttribute; else if (pFill->IsAThreeColFill ()) pNewFill = new ThreeColFillAttribute; else if (pFill->IsAFractalFill ()) pNewFill = new FractalFillAttribute; else if (pFill->IsANoiseFill ()) pNewFill = new NoiseFillAttribute; else if (pFill->IsABitmapFill ()) pNewFill = new BitmapFillAttribute; else { pNewFill = NULL; ERROR3 ("AIEPSRenderRegion::IncludeGradientFill - Unrecognised fill included"); } // Copy fill data if the the fill is recognised. There's no point in doing this if // we didn't recognise the fill, as the copy is bound to be different to the original. if (pNewFill != NULL) { // Copy all the relevant info. *(pNewFill) = *pFill; ERROR3IF ( !(*pFill == *pNewFill), "AIEPSRenderRegion::IncludeGradientFill - Copied fill doesn't match original"); // New Fill is built, so add it into either the radial or linear list. if (pFill->IsARadialFill () || pFill->IsASquareFill ()) { pNewList = new ListFill (pNewFill, effect, m_pRadialGradList); m_pRadialGradList = pNewList; } else { pNewList = new ListFill (pNewFill, effect, m_pLinearGradList); m_pLinearGradList = pNewList; } } } }

void AIEPSRenderRegion::Initialise (   )  [protected, virtual]

Sets up render region - it outputs the AIEPS file header comments, and intialises the rendering attributes. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 29/3/00 See also: EPSRenderRegion::Initialise, EPSRenderRegion::InitAttributes Definition at line 531 of file ai_epsrr.cpp. { // Set up member variables. m_a = 1; m_b = 0; m_c = 0; m_d = 1; m_T = DocCoord ( 0, 0 ); m_ActiveLayer = FALSE; m_LayerColour = 0; ClearGradientCache (); // Call the EPSRenderRegion method to re-enter the export loop. EPSRenderRegion::InitAttributes (); }

BOOL AIEPSRenderRegion::IsGradientFillValidForExport (  FillGeometryAttribute *  pFill  )  [virtual]

Determines whether a particular fill can be used through the AI export See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 15/01/01 Definition at line 3383 of file ai_epsrr.cpp. { BOOL acceptable = FALSE; if ( pFill->IsAColourFill () && // Is it a colour fill? pFill->IsAGradFill () && // Is it a graduated fill? ! (pFill->IsAFractalFill ()) && // Is it not a fractal (clouds) fill? ! (pFill->IsANoiseFill ()) && // Is it not a fractal (plasma) fill? ! (pFill->IsABitmapFill ()) ) // Is it not a bitmap fill? { acceptable = TRUE; } else { acceptable = FALSE; } return acceptable; }

BOOL AIEPSRenderRegion::LoadBitmapMatrix (  NodeBitmap *  pNodeBMP  )  [private]

This code generates a matrix to position and manipulate a bitmap within an AI file. Roughly, it calculates the angle of rotation, followed by the skew angle, and creates a matrix using these values. See Also: FlashExportDC::WriteBitmapFill (). Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 4/4/00 Parameters: pNodeBitmap  - A pointer to the bitmap node being exported. [INPUTS] Returns: TRUE - Successful. FALSE - An error has occured. Definition at line 1402 of file ai_epsrr.cpp. { // Step 1: Extract the co-ordinates of three corners from the bitmap record, and store // them as named co-ordinates within this function. The names are a historical // reference to the original names within the FlashExportDC, and refer to the // positions of a bitmap fill. double Angle = pNodeBMP->GetRotationAngle (); double SinRotate = sin ( Angle ); double CosRotate = cos ( Angle ); // double Skew = 0; DocCoord LowLeft = pNodeBMP->Parallel [3]; // Low corner of the bitmap. DocCoord TopLeft = pNodeBMP->Parallel [0]; // Max Y corner. DocCoord LowRight = pNodeBMP->Parallel [2]; // Max X corner. // Step 2: Calculate the normalised dot product of the two vectors, and this forms // the cosine of their internal angle. double WidthX = static_cast<double> ( LowLeft.x - LowRight.x ) / 1000; double WidthY = static_cast<double> ( LowLeft.y - LowRight.y ) / 1000; double HeightX = static_cast<double> ( TopLeft.x - LowLeft.x ) / 1000; double HeightY = static_cast<double> ( TopLeft.y - LowLeft.y ) / 1000; // Get the lengths of these vectors to normalise the dot-product. (Necessary for the // trignometric function calculations.) double Width = sqrt ( ( WidthX * WidthX ) + ( WidthY * WidthY ) ); double Height = sqrt ( ( HeightX * HeightX ) + ( HeightY * HeightY ) ); /* // The dot product calculation. By normalising the result, the cosine of the angle is // calculated. double CosSkew = ( ( WidthX * HeightX ) + ( HeightY * WidthY ) ) / ( Height * Width ); double SinSkew = sqrt ( 1 - ( CosSkew * CosSkew ) ); // Multiply the width of the shape by the sine derived from the dot product. This will // give the actual width, and not the one distorted by skewing. Width *= SinSkew; // If the DotSine value is not 0, calculate the tan value that forms the skew angle. // Since tan is undefined for 0, I'm ignoring this state. if ( SinSkew != 0 ) { Skew = - CosSkew / SinSkew; } */ // Grab a reference to the bitmap, and pull it's height and width from it. KernelBitmap *pBitmap = pNodeBMP->GetBitmap (); // A reference to the bitmap. double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); // Catch BMPWidth or BMPHeight set to zero. This shouldn't happen... if ( BMPWidth == 0 ) BMPWidth = 1; if ( BMPHeight == 0 ) BMPHeight = 1; // Step 4: Use the above values to calculate the values with which to populate the // transformation matrix. double ScaleX = Width / BMPWidth; double ScaleY = Height / BMPHeight; // Step 5: Use these to build the matrix. The variables a, b, c, d refer to the AI // matrix entries. The form of the matrix is: // // | SinRotate CosRotate | | ScaleX 0 | // | -CosRotate SinRotate | | Skew * ScaleY ScaleY | m_a = ( SinRotate * ScaleX ); // + ( CosRotate * Skew * ScaleY ); m_b = ( - CosRotate * ScaleX ); // + ( SinRotate * Skew * ScaleY ); m_c = CosRotate * ScaleY; m_d = SinRotate * ScaleY; // There's a weird bug with the AI export, in that a small (>0.0001) value is misread // by Adobe Illustrator as a monstrous value. To get around this, I'm going to set all // near zero values to zero. if ( Absol ( m_a ) < 1e-4 ) { m_a = 0; } if ( Absol ( m_b ) < 1e-4 ) { m_b = 0; } if ( Absol ( m_c ) < 1e-4 ) { m_c = 0; } if ( Absol ( m_d ) < 1e-4 ) { m_d = 0; } // Step 6: Calculate the translation part of the matrix. m_T = TopLeft; return TRUE; }

BOOL AIEPSRenderRegion::LoadTranslationMatrix (  DocCoord &  Translation  )  [private]

Loads the matrix with:. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 10/4/00 Parameters: -  [INPUTS] Returns: TRUE - Success. FALSE - An error occured. | 1 0 Translation.x | | 0 1 Translation.y | Which can then be written with WriteLoadedMatrix. See also: AIESPRenderRegion::LoadBitmapMatrix, AIEPSRenderRegion::WriteLoadedMatrix Definition at line 1524 of file ai_epsrr.cpp. { // Set the transformation part of the matrix to be the identity matrix. m_a = 1; m_b = 0; m_c = 0; m_d = 1; // And load up the translation value. m_T = Translation; return TRUE; }

void AIEPSRenderRegion::OutputDashPattern (   )  [protected, virtual]

Outputs EPS dash pattern values. This function currently only exists so that extra handling can be easily achieved for Illustrator EPS export of dash patterns in the future (if need be). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: EPSRenderRegion::OutputDashPattern (); EPSRenderRegion::OutputDashPatternInit(); Reimplemented from EPSRenderRegion. Definition at line 2141 of file ai_epsrr.cpp. { EPSRenderRegion::OutputDashPattern (); }

void AIEPSRenderRegion::OutputFillCMYKColour (   )  [protected, virtual]

Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Reimplemented from EPSRenderRegion. Definition at line 3167 of file ai_epsrr.cpp. { // NOTE: We need to export any changes to the overflow text here, // as it's the last place we can catch the colour change. if (ExportingOnPath ()) { PColourCMYK CMYK; OverflowT