KiCad PCB EDA Suite
Loading...
Searching...
No Matches
eda_text.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2013 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, you may find one here:
19 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20 * or you may search the http://www.gnu.org website for the version 2 license,
21 * or you may write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 */
24
25#ifndef EDA_TEXT_H_
26#define EDA_TEXT_H_
27
28#include <memory>
29#include <vector>
30
31#include <eda_search_data.h>
32#include <font/glyph.h>
34#include <api/serializable.h>
35
36
37class OUTPUTFORMATTER;
38class SHAPE_COMPOUND;
39class SHAPE_POLY_SET;
40
41
42// These are only here for algorithmic safety, not to tell the user what to do.
43// PL_EDITOR has the least resolution (its internal units are microns), so the min size is chosen
44// to yield 1 in PL_EDITOR.
45// The max size chosen is somewhat arbitrary, but no one has complained yet.
46#define TEXT_MIN_SIZE_MM 0.001
47#define TEXT_MAX_SIZE_MM 250.0
48
49
50namespace KIGFX
51{
52 class RENDER_SETTINGS;
53 class COLOR4D;
54}
55
56namespace KIFONT
57{
58 class METRICS;
59 }
60
62using KIGFX::COLOR4D;
63
64
69#define DEFAULT_SIZE_TEXT 50 // default text height (in mils, i.e. 1/1000")
70
71
78class EDA_TEXT : public SERIALIZABLE
79{
80public:
81 EDA_TEXT( const EDA_IU_SCALE& aIuScale, const wxString& aText = wxEmptyString );
82
83 EDA_TEXT( const EDA_TEXT& aText );
84
85 virtual ~EDA_TEXT();
86
87 EDA_TEXT& operator=( const EDA_TEXT& aItem );
88
89 void Serialize( google::protobuf::Any &aContainer ) const override;
90 bool Deserialize( const google::protobuf::Any &aContainer ) override;
91
97 virtual const wxString& GetText() const { return m_text; }
98
108 virtual wxString GetShownText( bool aAllowExtraText, int aDepth = 0 ) const
109 {
110 return m_shown_text;
111 }
112
117
118 virtual void SetText( const wxString& aText );
119
120 wxString EvaluateText( const wxString& aText ) const;
121
126 void SetTextThickness( int aWidth );
127 int GetTextThickness() const { return m_attributes.m_StrokeWidth; };
128
130 {
131 if( GetAutoThickness() )
133 else
134 return GetTextThickness();
135 }
136
137 void SetAutoThickness( bool aAuto );
138 bool GetAutoThickness() const { return GetTextThickness() == 0; };
139
143 int GetEffectiveTextPenWidth( int aDefaultPenWidth = 0 ) const;
144
145 virtual void SetTextAngle( const EDA_ANGLE& aAngle );
146 const EDA_ANGLE& GetTextAngle() const { return m_attributes.m_Angle; }
147
148 // For property system:
149 void SetTextAngleDegrees( double aOrientation )
150 {
151 SetTextAngle( EDA_ANGLE( aOrientation, DEGREES_T ) );
152 }
153 double GetTextAngleDegrees() const { return m_attributes.m_Angle.AsDegrees(); }
154
160 void SetItalic( bool aItalic );
161
167 void SetItalicFlag( bool aItalic );
168 bool IsItalic() const { return m_attributes.m_Italic; }
169
175 void SetBold( bool aBold );
176
182 void SetBoldFlag( bool aBold );
183 bool IsBold() const { return m_attributes.m_Bold; }
184
185 virtual void SetVisible( bool aVisible );
186 virtual bool IsVisible() const { return m_visible; }
187
188 void SetMirrored( bool isMirrored );
189 bool IsMirrored() const { return m_attributes.m_Mirrored; }
190
195 void SetMultilineAllowed( bool aAllow );
196 bool IsMultilineAllowed() const { return m_attributes.m_Multiline; }
197
199 GR_TEXT_H_ALIGN_T GetHorizJustify() const { return m_attributes.m_Halign; };
200
201 void SetVertJustify( GR_TEXT_V_ALIGN_T aType );
202 GR_TEXT_V_ALIGN_T GetVertJustify() const { return m_attributes.m_Valign; };
203
204 void SetKeepUpright( bool aKeepUpright );
205 bool IsKeepUpright() const { return m_attributes.m_KeepUpright; }
206
214
218 void SetAttributes( const EDA_TEXT& aSrc, bool aSetPosition = true );
219
223 void SwapAttributes( EDA_TEXT& aTradingPartner );
224
225 void SwapText( EDA_TEXT& aTradingPartner );
226
227 void CopyText( const EDA_TEXT& aSrc );
228
229 void SetAttributes( const TEXT_ATTRIBUTES& aTextAttrs ) { m_attributes = aTextAttrs; }
230 const TEXT_ATTRIBUTES& GetAttributes() const { return m_attributes; }
231
241 bool Replace( const EDA_SEARCH_DATA& aSearchData );
242
243 bool IsDefaultFormatting() const;
244
245 void SetFont( KIFONT::FONT* aFont );
246 KIFONT::FONT* GetFont() const { return m_attributes.m_Font; }
247
248 void SetUnresolvedFontName( const wxString& aFontName ) { m_unresolvedFontName = aFontName; }
249 bool ResolveFont( const std::vector<wxString>* aEmbeddedFonts );
250
251 wxString GetFontName() const;
252
253 void SetFontProp( const wxString& aFontName );
254 wxString GetFontProp() const;
255
256 void SetLineSpacing( double aLineSpacing );
257 double GetLineSpacing() const { return m_attributes.m_LineSpacing; }
258
259 void SetTextSize( VECTOR2I aNewSize, bool aEnforceMinTextSize = true );
260 VECTOR2I GetTextSize() const { return m_attributes.m_Size; }
261
262 void SetTextWidth( int aWidth );
263 int GetTextWidth() const { return m_attributes.m_Size.x; }
264
265 void SetTextHeight( int aHeight );
266 int GetTextHeight() const { return m_attributes.m_Size.y; }
267
268 void SetTextColor( const COLOR4D& aColor ) { m_attributes.m_Color = aColor; }
269 COLOR4D GetTextColor() const { return m_attributes.m_Color; }
270
271 void SetTextPos( const VECTOR2I& aPoint );
272 const VECTOR2I& GetTextPos() const { return m_pos; }
273
274 void SetTextX( int aX );
275 void SetTextY( int aY );
276
277 void Offset( const VECTOR2I& aOffset );
278
279 void Empty();
280
281 static GR_TEXT_H_ALIGN_T MapHorizJustify( int aHorizJustify );
282 static GR_TEXT_V_ALIGN_T MapVertJustify( int aVertJustify );
283
291 void Print( const RENDER_SETTINGS* aSettings, const VECTOR2I& aOffset, const COLOR4D& aColor );
292
299 std::shared_ptr<SHAPE_COMPOUND> GetEffectiveTextShape( bool aTriangulate = true,
300 const BOX2I& aBBox = BOX2I(),
301 const EDA_ANGLE& aAngle = ANGLE_0 ) const;
302
310 virtual bool TextHitTest( const VECTOR2I& aPoint, int aAccuracy = 0 ) const;
311
320 virtual bool TextHitTest( const BOX2I& aRect, bool aContains, int aAccuracy = 0 ) const;
321
331 BOX2I GetTextBox( const RENDER_SETTINGS* aSettings, int aLine = -1 ) const;
332
340 int GetInterline( const RENDER_SETTINGS* aSettings ) const;
341
345 wxString GetTextStyleName() const;
346
354 void GetLinePositions( const RENDER_SETTINGS* aSettings, std::vector<VECTOR2I>& aPositions,
355 int aLineCount ) const;
356
362 double Levenshtein( const EDA_TEXT& aOther ) const;
363
364
365 double Similarity( const EDA_TEXT& aOther ) const;
366
374 virtual void Format( OUTPUTFORMATTER* aFormatter, int aControlBits ) const;
375
376 virtual EDA_ANGLE GetDrawRotation() const { return GetTextAngle(); }
377 virtual VECTOR2I GetDrawPos() const { return GetTextPos(); }
378
379 virtual KIFONT::FONT* GetDrawFont( const RENDER_SETTINGS* aSettings ) const;
380
381 virtual void ClearRenderCache();
382 virtual void ClearBoundingBoxCache();
383
384 std::vector<std::unique_ptr<KIFONT::GLYPH>>*
385 GetRenderCache( const KIFONT::FONT* aFont, const wxString& forResolvedText,
386 const VECTOR2I& aOffset = { 0, 0 } ) const;
387
388 // Support for reading the cache from disk.
389 void SetupRenderCache( const wxString& aResolvedText, const KIFONT::FONT* aFont,
390 const EDA_ANGLE& aAngle, const VECTOR2I& aOffset );
391 void AddRenderCacheGlyph( const SHAPE_POLY_SET& aPoly );
392
393 int Compare( const EDA_TEXT* aOther ) const;
394
395 bool operator==( const EDA_TEXT& aRhs ) const { return Compare( &aRhs ) == 0; }
396 bool operator<( const EDA_TEXT& aRhs ) const { return Compare( &aRhs ) < 0; }
397 bool operator>( const EDA_TEXT& aRhs ) const { return Compare( &aRhs ) > 0; }
398
399 virtual bool HasHyperlink() const { return !m_hyperlink.IsEmpty(); }
400 wxString GetHyperlink() const { return m_hyperlink; }
401 void SetHyperlink( wxString aLink ) { m_hyperlink = aLink; }
402 void RemoveHyperlink() { m_hyperlink = wxEmptyString; }
403
410 static bool ValidateHyperlink( const wxString& aURL );
411
420 static bool IsGotoPageHref( const wxString& aHref, wxString* aDestination = nullptr );
421
428 static wxString GotoPageHref( const wxString& aDestination );
429
430protected:
431 virtual const KIFONT::METRICS& getFontMetrics() const;
432
433 virtual void cacheShownText();
434
443 void printOneLineOfText( const RENDER_SETTINGS* aSettings, const VECTOR2I& aOffset,
444 const COLOR4D& aColor, const wxString& aText, const VECTOR2I& aPos );
445
446protected:
450 wxString m_hyperlink;
451
452private:
453 wxString m_text;
454 wxString m_shown_text; // Cache of unescaped text for efficient access
456
457 std::reference_wrapper<const EDA_IU_SCALE> m_IuScale;
458
459 mutable wxString m_render_cache_text;
463 mutable std::vector<std::unique_ptr<KIFONT::GLYPH>> m_render_cache;
464
470
471 mutable std::map<int, BBOX_CACHE_ENTRY> m_bbox_cache;
472
476 bool m_visible; // For SCH_FIELDs and PCB_FIELDs
477};
478
479
480extern std::ostream& operator<<( std::ostream& aStream, const EDA_TEXT& aAttributes );
481
482
483template<>
484struct std::hash<EDA_TEXT>
485{
486 std::size_t operator()( const EDA_TEXT& aText ) const
487 {
488 return hash_val( aText.GetText(), aText.GetAttributes(), aText.GetTextPos().x,
489 aText.GetTextPos().y );
490 }
491};
492
493#endif // EDA_TEXT_H_
BOX2< VECTOR2I > BOX2I
Definition box2.h:922
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition eda_text.h:79
int GetTextHeight() const
Definition eda_text.h:266
void Serialize(google::protobuf::Any &aContainer) const override
Serializes this object to the given Any message.
Definition eda_text.cpp:188
void SetTextColor(const COLOR4D &aColor)
Definition eda_text.h:268
const VECTOR2I & GetTextPos() const
Definition eda_text.h:272
COLOR4D GetTextColor() const
Definition eda_text.h:269
wxString GetTextStyleName() const
Definition eda_text.cpp:975
VECTOR2I m_pos
Definition eda_text.h:475
wxString m_text
Definition eda_text.h:453
std::map< int, BBOX_CACHE_ENTRY > m_bbox_cache
Definition eda_text.h:471
bool IsDefaultFormatting() const
static bool IsGotoPageHref(const wxString &aHref, wxString *aDestination=nullptr)
Check if aHref is a valid internal hyperlink.
void SetFontProp(const wxString &aFontName)
std::vector< std::unique_ptr< KIFONT::GLYPH > > m_render_cache
Definition eda_text.h:463
wxString GetFontName() const
Definition eda_text.cpp:996
virtual ~EDA_TEXT()
Definition eda_text.cpp:150
bool IsItalic() const
Definition eda_text.h:168
const EDA_ANGLE & GetTextAngle() const
Definition eda_text.h:146
bool m_visible
Definition eda_text.h:476
void SetTextSize(VECTOR2I aNewSize, bool aEnforceMinTextSize=true)
Definition eda_text.cpp:534
void SetUnresolvedFontName(const wxString &aFontName)
Definition eda_text.h:248
bool IsMultilineAllowed() const
Definition eda_text.h:196
virtual const wxString & GetText() const
Return the string associated with the text object.
Definition eda_text.h:97
bool IsKeepUpright() const
Definition eda_text.h:205
virtual bool IsVisible() const
Definition eda_text.h:186
void SetTextPos(const VECTOR2I &aPoint)
Definition eda_text.cpp:579
void SetTextX(int aX)
Definition eda_text.cpp:585
bool m_shown_text_has_text_var_refs
Definition eda_text.h:455
bool Deserialize(const google::protobuf::Any &aContainer) override
Deserializes the given protobuf message into this object.
Definition eda_text.cpp:224
KIFONT::FONT * GetFont() const
Definition eda_text.h:246
void SetAttributes(const TEXT_ATTRIBUTES &aTextAttrs)
Definition eda_text.h:229
bool ResolveFont(const std::vector< wxString > *aEmbeddedFonts)
Definition eda_text.cpp:508
void SetAttributes(const EDA_TEXT &aSrc, bool aSetPosition=true)
Set the text attributes from another instance.
Definition eda_text.cpp:434
wxString m_shown_text
Definition eda_text.h:454
void SetMirrored(bool isMirrored)
Definition eda_text.cpp:394
wxString GetFontProp() const
void SetTextY(int aY)
Definition eda_text.cpp:591
std::vector< std::unique_ptr< KIFONT::GLYPH > > * GetRenderCache(const KIFONT::FONT *aFont, const wxString &forResolvedText, const VECTOR2I &aOffset={ 0, 0 }) const
Definition eda_text.cpp:685
const KIFONT::FONT * m_render_cache_font
Definition eda_text.h:460
virtual EDA_ANGLE GetDrawRotation() const
Definition eda_text.h:376
wxString m_unresolvedFontName
Definition eda_text.h:474
virtual VECTOR2I GetDrawPos() const
Definition eda_text.h:377
EDA_TEXT & operator=(const EDA_TEXT &aItem)
Definition eda_text.cpp:155
wxString m_hyperlink
A hyperlink URL.
Definition eda_text.h:450
int GetTextWidth() const
Definition eda_text.h:263
BOX2I GetTextBox(const RENDER_SETTINGS *aSettings, int aLine=-1) const
Useful in multiline texts to calculate the full text or a line area (for zones filling,...
Definition eda_text.cpp:744
virtual bool HasHyperlink() const
Definition eda_text.h:399
void SetVertJustify(GR_TEXT_V_ALIGN_T aType)
Definition eda_text.cpp:418
wxString GetHyperlink() const
Definition eda_text.h:400
void Offset(const VECTOR2I &aOffset)
Definition eda_text.cpp:597
virtual void Format(OUTPUTFORMATTER *aFormatter, int aControlBits) const
Output the object to aFormatter in s-expression form.
GR_TEXT_H_ALIGN_T GetHorizJustify() const
Definition eda_text.h:199
void SetTextWidth(int aWidth)
Definition eda_text.cpp:557
virtual KIFONT::FONT * GetDrawFont(const RENDER_SETTINGS *aSettings) const
Definition eda_text.cpp:650
void SetBoldFlag(bool aBold)
Set only the bold flag, without changing the font.
Definition eda_text.cpp:379
bool Replace(const EDA_SEARCH_DATA &aSearchData)
Helper function used in search and replace dialog.
Definition eda_text.cpp:487
void SetupRenderCache(const wxString &aResolvedText, const KIFONT::FONT *aFont, const EDA_ANGLE &aAngle, const VECTOR2I &aOffset)
Definition eda_text.cpp:720
int Compare(const EDA_TEXT *aOther) const
std::reference_wrapper< const EDA_IU_SCALE > m_IuScale
Definition eda_text.h:457
bool HasTextVars() const
Indicates the ShownText has text var references which need to be processed.
Definition eda_text.h:116
bool operator>(const EDA_TEXT &aRhs) const
Definition eda_text.h:397
virtual void SetVisible(bool aVisible)
Definition eda_text.cpp:387
EDA_TEXT(const EDA_IU_SCALE &aIuScale, const wxString &aText=wxEmptyString)
Definition eda_text.cpp:96
static wxString GotoPageHref(const wxString &aDestination)
Generate a href to a page in the current schematic.
virtual void ClearBoundingBoxCache()
Definition eda_text.cpp:678
bool GetAutoThickness() const
Definition eda_text.h:138
double GetLineSpacing() const
Definition eda_text.h:257
double Similarity(const EDA_TEXT &aOther) const
VECTOR2I m_render_cache_offset
Definition eda_text.h:462
void SetLineSpacing(double aLineSpacing)
Definition eda_text.cpp:526
wxString EvaluateText(const wxString &aText) const
Definition eda_text.cpp:642
void AddRenderCacheGlyph(const SHAPE_POLY_SET &aPoly)
Definition eda_text.cpp:731
void Empty()
Definition eda_text.cpp:616
void SetTextThickness(int aWidth)
The TextThickness is that set by the user.
Definition eda_text.cpp:285
virtual bool TextHitTest(const VECTOR2I &aPoint, int aAccuracy=0) const
Test if aPoint is within the bounds of this object.
Definition eda_text.cpp:871
void FlipHJustify()
Definition eda_text.h:207
void SetTextHeight(int aHeight)
Definition eda_text.cpp:568
virtual void cacheShownText()
Definition eda_text.cpp:624
EDA_ANGLE m_render_cache_angle
Definition eda_text.h:461
static GR_TEXT_H_ALIGN_T MapHorizJustify(int aHorizJustify)
Definition eda_text.cpp:68
virtual void ClearRenderCache()
Definition eda_text.cpp:672
void RemoveHyperlink()
Definition eda_text.h:402
const TEXT_ATTRIBUTES & GetAttributes() const
Definition eda_text.h:230
void SetBold(bool aBold)
Set the text to be bold - this will also update the font if needed.
Definition eda_text.cpp:336
static bool ValidateHyperlink(const wxString &aURL)
Check if aURL is a valid hyperlink.
void SetItalicFlag(bool aItalic)
Set only the italic flag, without changing the font.
Definition eda_text.cpp:328
void SetAutoThickness(bool aAuto)
Definition eda_text.cpp:293
bool IsMirrored() const
Definition eda_text.h:189
int GetEffectiveTextPenWidth(int aDefaultPenWidth=0) const
The EffectiveTextPenWidth uses the text thickness if > 1 or aDefaultPenWidth.
Definition eda_text.cpp:466
void SwapAttributes(EDA_TEXT &aTradingPartner)
Swap the text attributes of the two involved instances.
Definition eda_text.cpp:453
wxString m_render_cache_text
Definition eda_text.h:459
void Print(const RENDER_SETTINGS *aSettings, const VECTOR2I &aOffset, const COLOR4D &aColor)
Print this text object to the device context aDC.
Definition eda_text.cpp:890
double GetTextAngleDegrees() const
Definition eda_text.h:153
void GetLinePositions(const RENDER_SETTINGS *aSettings, std::vector< VECTOR2I > &aPositions, int aLineCount) const
Populate aPositions with the position of each line of a multiline text, according to the vertical jus...
Definition eda_text.cpp:912
virtual const KIFONT::METRICS & getFontMetrics() const
Definition eda_text.cpp:666
std::shared_ptr< SHAPE_COMPOUND > GetEffectiveTextShape(bool aTriangulate=true, const BOX2I &aBBox=BOX2I(), const EDA_ANGLE &aAngle=ANGLE_0) const
build a list of segments (SHAPE_SEGMENT) to describe a text shape.
bool operator<(const EDA_TEXT &aRhs) const
Definition eda_text.h:396
bool IsBold() const
Definition eda_text.h:183
void SetTextAngleDegrees(double aOrientation)
Definition eda_text.h:149
void SetHyperlink(wxString aLink)
Definition eda_text.h:401
static GR_TEXT_V_ALIGN_T MapVertJustify(int aVertJustify)
Definition eda_text.cpp:82
void SetKeepUpright(bool aKeepUpright)
Definition eda_text.cpp:426
void CopyText(const EDA_TEXT &aSrc)
Definition eda_text.cpp:278
GR_TEXT_V_ALIGN_T GetVertJustify() const
Definition eda_text.h:202
int GetInterline(const RENDER_SETTINGS *aSettings) const
Return the distance between two lines of text.
Definition eda_text.cpp:738
int GetTextThicknessProperty() const
Definition eda_text.h:129
virtual wxString GetShownText(bool aAllowExtraText, int aDepth=0) const
Return the string actually shown after processing of the base text.
Definition eda_text.h:108
virtual void SetText(const wxString &aText)
Definition eda_text.cpp:271
double Levenshtein(const EDA_TEXT &aOther) const
Return the levenstein distance between two texts.
virtual void SetTextAngle(const EDA_ANGLE &aAngle)
Definition eda_text.cpp:300
int GetTextThickness() const
Definition eda_text.h:127
void SetItalic(bool aItalic)
Set the text to be italic - this will also update the font if needed.
Definition eda_text.cpp:308
void SwapText(EDA_TEXT &aTradingPartner)
Definition eda_text.cpp:446
bool operator==(const EDA_TEXT &aRhs) const
Definition eda_text.h:395
void SetMultilineAllowed(bool aAllow)
Definition eda_text.cpp:402
void SetFont(KIFONT::FONT *aFont)
Definition eda_text.cpp:500
void printOneLineOfText(const RENDER_SETTINGS *aSettings, const VECTOR2I &aOffset, const COLOR4D &aColor, const wxString &aText, const VECTOR2I &aPos)
Print each line of this EDA_TEXT.
Definition eda_text.cpp:957
VECTOR2I GetTextSize() const
Definition eda_text.h:260
void SetHorizJustify(GR_TEXT_H_ALIGN_T aType)
Definition eda_text.cpp:410
TEXT_ATTRIBUTES m_attributes
Definition eda_text.h:473
FONT is an abstract base class for both outline and stroke fonts.
Definition font.h:131
A color representation with 4 components: red, green, blue, alpha.
Definition color4d.h:104
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
An interface used to output 8 bit text in a convenient way.
Definition richio.h:322
Interface for objects that can be serialized to Protobuf messages.
Represent a set of closed polygons.
static constexpr EDA_ANGLE ANGLE_0
Definition eda_angle.h:411
@ DEGREES_T
Definition eda_angle.h:31
std::ostream & operator<<(std::ostream &aStream, const EDA_TEXT &aAttributes)
static constexpr std::size_t hash_val(const Types &... args)
Definition hash.h:51
The Cairo implementation of the graphics abstraction layer.
Definition eda_group.h:33
Definition eda_text.h:466
VECTOR2I m_pos
Definition eda_text.h:467
BOX2I m_bbox
Definition eda_text.h:468
std::size_t operator()(const EDA_TEXT &aText) const
Definition eda_text.h:486
GR_TEXT_H_ALIGN_T
This is API surface mapped to common.types.HorizontalAlignment.
@ GR_TEXT_H_ALIGN_RIGHT
@ GR_TEXT_H_ALIGN_LEFT
GR_TEXT_V_ALIGN_T
This is API surface mapped to common.types.VertialAlignment.
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:695