Represents "name" table of the TTF Font file. More...
Inherits Aspose::Font::TtfTables::TtfTableBase.
Classes | |
| class | NameEventArgs |
| class | NameRecord |
| Represents NameRecord structure of the 'name' table More... | |
| class | NameRecordList |
Public Member Functions | |
| ASPOSE_FONT_SHARED_API void | AddName (TtfNameTable::NameId nameId, TtfNameTable::PlatformId platformId, int32_t platformSpecificId, int32_t languageId, System::String name) |
| Adds entry into the table. String data category to add is specified by name parameter. More... | |
| ASPOSE_FONT_SHARED_API void | DeleteRecordsByNameId (TtfNameTable::NameId nameId) |
| Deletes all the records related to passed nameId parameter More... | |
| ASPOSE_FONT_SHARED_API void | DeleteRecords (TtfNameTable::PlatformId platformId, uint16_t platformSpecificId, TtfNameTable::NameId nameId) |
| Deletes all the records related to passed parameters More... | |
| ASPOSE_FONT_SHARED_API void | DeleteRecords (TtfNameTable::PlatformId platformId, uint16_t platformSpecificId) |
| Deletes all the records related to platform specified More... | |
| ASPOSE_FONT_SHARED_API void | DeleteRecords (TtfNameTable::PlatformId platformId, uint16_t platformSpecificId, TtfNameTable::NameId nameId, uint16_t languageId) |
| Deletes record(s) related to parameters specified More... | |
| ASPOSE_FONT_SHARED_API void | UpdateName (TtfNameTable::PlatformId platformId, uint16_t platformSpecificId, TtfNameTable::NameId nameId, uint16_t languageId, System::String newName) |
| Updates name in record(s) which related to specified platform (combination of platformId and platformSpecificId), category (nameId) and language (languageId). More... | |
| ASPOSE_FONT_SHARED_API void | UpdateNamesByNameId (TtfNameTable::NameId nameId, System::String newName) |
| Selects all records which related to logical string category, specified by parameter nameId and updates name field (string data) in these records. Fields related to platform (platformID, Platform-specific encoding ID) and language (Language ID) are not affected by this method. Only name string data is replaced with a new name. Use this method with caution, cause it will replace original names for all platforms and languages, related to nameId. It can make a conflicts for cases when original names had different values, cause replace operation changes all these values with new single one.And this new value may have a logical inconsistency with some platforms and languages. This method is useful for cases when original name has single representation for all platforms and languages, for example, when name string data is in english language. More... | |
| ASPOSE_FONT_SHARED_API void | AddMultiLanguageNames (System::SharedPtr< MultiLanguageString > mlNames, TtfNameTable::PlatformId platformId, uint16_t platformSpecificId, TtfNameTable::NameId nameId) |
| Extracts all multilingual strings from passed mlNames object and creates correspondent NameRecord structure for every string extracted using passed parameters platformId , platformSpecificId and nameId . Value for field languageID is extracted from mlNames object. New just created record is added into table. If record which coincides with just created by fields platformID, platformSpecificID, nameID and, langugeId will be found, then new created record will not be added and only string data will be updated for existing record. More... | |
| ASPOSE_FONT_SHARED_API System::String | GetNameById (TtfNameTable::NameId nameId) |
| Returns a name by nameId if found, null otherwise More... | |
| ASPOSE_FONT_SHARED_API System::SharedPtr< MultiLanguageString > | GetMultiLanguageNameById (TtfNameTable::NameId nameId) |
| Returns a name by nameId. More... | |
| ASPOSE_FONT_SHARED_API System::SharedPtr< MultiLanguageString > | GetMultiLanguageNameById (TtfNameTable::NameId nameId, TtfNameTable::PlatformId platformId) |
| Returns a name by nameId using platform identifier passed. More... | |
| ASPOSE_FONT_SHARED_API System::SharedPtr< MultiLanguageString > | GetMultiLanguageNameById (TtfNameTable::NameId nameId, TtfNameTable::PlatformId platformId, uint16_t platformSpecificId) |
| Returns a name as object of type MultiLanguageString. Method collects all NameRecord structures which coincide with passed parameters nameId, platformId and platformSpecificId and then builds resultant object based on this structures list. More... | |
| ASPOSE_FONT_SHARED_API System::ArrayPtr< System::SharedPtr< TtfNameTable::NameRecord > > | GetAllNameRecords () |
| Returns all NameRecord structures from table More... | |
| ASPOSE_FONT_SHARED_API System::ArrayPtr< System::SharedPtr< TtfNameTable::NameRecord > > | GetNameRecordsByNameId (TtfNameTable::NameId nameId) |
| Returns all NameRecord structures which NameId field is equal to passed nameId value. If no records found, empty array will be returned. More... | |
 Public Member Functions inherited from Aspose::Font::TtfTables::TtfTableBase | |
| ASPOSE_FONT_SHARED_API System::SharedPtr< TtfTableRepository > | get_TtfTables () const |
| Reference to TTF table repository. More... | |
| ASPOSE_FONT_SHARED_API uint32_t | get_Offset () const |
| Gets offset from beginning of sfnt. More... | |
| Public Member Functions inherited from System::Object | |
| ASPOSECPP_SHARED_API | Object () |
| Creates object. Initializes all internal data structures. More... | |
| virtual ASPOSECPP_SHARED_API | ~Object () |
| Destroys object. Frees all internal data structures. More... | |
| ASPOSECPP_SHARED_API | Object (Object const &x) |
| Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More... | |
| Object & | operator= (Object const &x) |
| Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More... | |
| Object * | SharedRefAdded () |
| Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More... | |
| int | SharedRefRemovedSafe () |
| Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More... | |
| int | RemovedSharedRefs (int count) |
| Decreases shared reference count by specified value. More... | |
| Detail::SmartPtrCounter * | WeakRefAdded () |
| Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More... | |
| void | WeakRefRemoved () |
| Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More... | |
| Detail::SmartPtrCounter * | GetCounter () |
| Gets reference counter data structure associated with the object. More... | |
| int | SharedCount () const |
| Gets current value of shared reference counter. More... | |
| ASPOSECPP_SHARED_API void | Lock () |
| Implements C# lock() statement locking. Call directly or use LockContext sentry object. More... | |
| ASPOSECPP_SHARED_API void | Unlock () |
| Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More... | |
| virtual ASPOSECPP_SHARED_API bool | Equals (ptr obj) |
| Compares objects using C# Object.Equals semantics. More... | |
| virtual ASPOSECPP_SHARED_API int32_t | GetHashCode () const |
| Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More... | |
| virtual ASPOSECPP_SHARED_API String | ToString () const |
| Analog of C# Object.ToString() method. Enables converting custom objects to string. More... | |
| virtual ASPOSECPP_SHARED_API ptr | MemberwiseClone () const |
| Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More... | |
| virtual ASPOSECPP_SHARED_API const TypeInfo & | GetType () const |
| Gets actual type of object. Analog of C# System.Object.GetType() call. More... | |
| virtual ASPOSECPP_SHARED_API bool | Is (const TypeInfo &targetType) const |
| Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More... | |
| virtual ASPOSECPP_SHARED_API void | SetTemplateWeakPtr (uint32_t argument) |
| Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More... | |
| virtual ASPOSECPP_SHARED_API bool | FastCast (const Details::FastRttiBase &helper, void **out_ptr) const |
| For internal purposes only. More... | |
| template<> | |
| bool | Equals (float const &objA, float const &objB) |
| Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More... | |
| template<> | |
| bool | Equals (double const &objA, double const &objB) |
| Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More... | |
| template<> | |
| bool | ReferenceEquals (String const &str, std::nullptr_t) |
| Specialization of Object::ReferenceEquals for case of string and nullptr. More... | |
| template<> | |
| bool | ReferenceEquals (String const &str1, String const &str2) |
| Specialization of Object::ReferenceEquals for case of strings. More... | |
Static Public Member Functions | |
| static ASPOSE_FONT_SHARED_API System::String | get_Tag () |
| Gets table tag. More... | |
| Static Public Member Functions inherited from System::Object | |
| static bool | ReferenceEquals (ptr const &objA, ptr const &objB) |
| Compares objects by reference. More... | |
| template<typename T > | |
| static std::enable_if<!IsSmartPtr< T >::value, bool >::type | ReferenceEquals (T const &objA, T const &objB) |
| Compares objects by reference. More... | |
| template<typename T > | |
| static std::enable_if<!IsSmartPtr< T >::value, bool >::type | ReferenceEquals (T const &objA, std::nullptr_t) |
| Reference-compares value type object with nullptr. More... | |
| template<typename T1 , typename T2 > | |
| static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type | Equals (T1 const &objA, T2 const &objB) |
| Compares reference type objects in C# style. More... | |
| template<typename T1 , typename T2 > | |
| static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type | Equals (T1 const &objA, T2 const &objB) |
| Compares value type objects in C# style. More... | |
| static const TypeInfo & | Type () |
| Implements C# typeof(System.Object) construct. More... | |
Protected Member Functions | |||||||
| bool | get_SaveRecordsWithEmptyString () const | ||||||
| Flag for saving NameRecords with empty property 'String' More... | |||||||
| void | set_SaveRecordsWithEmptyString (bool value) | ||||||
| Flag for saving NameRecords with empty property 'String' More... | |||||||
| TtfNameTable (System::SharedPtr< TtfTableRepository > ttfTables, System::SharedPtr< Aspose::Font::Ttf::TtfFont > font) | |||||||
| Initializes a new instance of the TtfNameTable class. More... | |||||||
| MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION (TtfNameTable, CODEPORTING_ARGS(System::SharedPtr< TtfTableRepository > ttfTables, System::SharedPtr< Aspose::Font::Ttf::TtfFont > font)) | |||||||
| TtfNameTable (System::SharedPtr< Aspose::Font::Ttf::Internals::TtfParserContext > context, uint32_t checkSum, uint32_t offset, uint32_t length) | |||||||
| MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION (TtfNameTable, CODEPORTING_ARGS(System::SharedPtr< Aspose::Font::Ttf::Internals::TtfParserContext > context, uint32_t checkSum, uint32_t offset, uint32_t length)) | |||||||
| ASPOSE_FONT_SHARED_API void | Load (System::SharedPtr< Aspose::Font::Ttf::Internals::Parsing::TTFFileReader > ttfReader) override | ||||||
| Loads current table More... | |||||||
| ASPOSE_FONT_SHARED_API void | Save (System::ArrayPtr< uint8_t > &tableBytes, uint32_t &length, uint32_t &checksum) override | ||||||
| Saves the table to font stream More... | |||||||
| ASPOSE_FONT_SHARED_API void | AssignDataFrom (System::SharedPtr< TtfTableBase > table) override | ||||||
| Designed to copy data from another table with same type, for example hhea->hhea, hmtx->hmtx. This mechanism can be helpful when table of generated font needed to copy data from another existing font(not generated) to avoid problems with linking to data source(source table from existing font has link to data source(offset, length), but this link data is superfluous for destination table, so full copy (method like Copy()) is not decision for this case. Let the table takes necessary data via this assigning mechanism. More... | |||||||
| void | AddNameById (TtfNameTable::NameId nameId, System::String name) | ||||||
| Adds name by NameId. More... | |||||||
| virtual ASPOSE_FONT_SHARED_API | ~TtfNameTable () | ||||||
| Protected Member Functions inherited from Aspose::Font::TtfTables::TtfTableBase | |||||||
| System::SharedPtr< Aspose::Font::Ttf::Internals::TtfParserContext > | get_Context () const | ||||||
| parser context More... | |||||||
| bool | get_IsNewFont () const | ||||||
| indicates that the font is new More... | |||||||
| void | set_IsNewFont (bool value) | ||||||
| indicates that the font is new More... | |||||||
| bool | get_IsModified () const | ||||||
| Indicates data state in current table, if this flag is true - table data was changd and needed to be saved. More... | |||||||
| void | set_IsModified (bool value) | ||||||
| Indicates data state in current table, if this flag is true - table data was changd and needed to be saved. More... | |||||||
| ASPOSE_FONT_SHARED_API uint32_t | get_Length () const | ||||||
| Gets length of this table in bytes (actual length not padded length). More... | |||||||
| TtfTableBase (System::SharedPtr< TtfTableRepository > ttfTables, System::SharedPtr< Aspose::Font::Ttf::TtfFont > font) | |||||||
| MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION (TtfTableBase, CODEPORTING_ARGS(System::SharedPtr< TtfTableRepository > ttfTables, System::SharedPtr< Aspose::Font::Ttf::TtfFont > font)) | |||||||
| TtfTableBase (System::SharedPtr< Aspose::Font::Ttf::Internals::TtfParserContext > context, uint32_t checkSum, uint32_t offset, uint32_t length) | |||||||
| MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION (TtfTableBase, CODEPORTING_ARGS(System::SharedPtr< Aspose::Font::Ttf::Internals::TtfParserContext > context, uint32_t checkSum, uint32_t offset, uint32_t length)) | |||||||
| void | LazyLoad () | ||||||
| virtual ASPOSE_FONT_SHARED_API void | LazyLoadImpl (System::SharedPtr< Aspose::Font::Ttf::Internals::Parsing::TTFFileReader > ttfReader) | ||||||
| virtual ASPOSE_FONT_SHARED_API bool | IsConsistent () | ||||||
| void | LoadInitialBytes (System::ArrayPtr< uint8_t > &tableBytes, uint32_t &length, uint32_t &checksum) | ||||||
Read the initial data (all bytes) of the table and save it to array of bytes
| |||||||
| virtual ASPOSE_FONT_SHARED_API void | SaveInitialBytes (System::ArrayPtr< uint8_t > &tableBytes, uint32_t &length, uint32_t &checksum) | ||||||
| Saves the initial bytes of the table More... | |||||||
| void | FinalizeWriting (System::SharedPtr< Aspose::Font::Ttf::Internals::Parsing::TTFFileWriter > writer, System::SharedPtr< System::IO::MemoryStream > stream, System::ArrayPtr< uint8_t > &tableBytes, uint32_t &length, uint32_t &checksum) | ||||||
Protected Attributes | |
| System::EventHandler | NameChanged |
| Protected Attributes inherited from Aspose::Font::TtfTables::TtfTableBase | |
| bool | IsLoaded |
| Used to detect whether table already loaded More... | |
Static Protected Attributes | |
| static const System::String | TAG |
| Table Tag. More... | |
| static const System::String | LowerTag |
Additional Inherited Members | |
| Static Protected Member Functions inherited from Aspose::Font::TtfTables::TtfTableBase | |
| static uint32_t | CalculateChecksum (System::ArrayPtr< uint8_t > data) |
Detailed Description
Represents "name" table of the TTF Font file.
Member Enumeration Documentation
◆ MacLanguageId
Macintosh platform language id enumeration.
◆ MacPlatformSpecificId
Represents Macintosh platform PlatformSpecificId enumeration.
◆ MSLanguageId
Microsoft platform language id enumeration.
◆ MSPlatformSpecificId
Represents Microsoft platform PlatformSpecificId enumeration.
◆ NameId
|
strong |
Represents NameId.
| Enumerator | |
|---|---|
| CopyrightNotice | 0 Copyright notice. |
| FontFamily | 1 Font Family. This string is the Font family name the user sees on Macintosh platforms. |
| FontSubfamily | 2 Font Subfamily. This string is the Font family the user sees on Macintosh platforms. |
| UniqueFontId | 3 Unique subfamily identification (Apple spec). 3 Unique Font identifier (MS spec). |
| FullName | 4 Full name of the Font. |
| Version | 5 Version of the name table. |
| PostScriptName | 6 PostScript name of the Font. Note: A Font may have only one PostScript name and that name must be ASCII. |
| TrademarkNotice | 7 Trademark notice. |
| ManufacturerName | 8 Manufacturer name. |
| DesignerName | 9 Designer; name of the designer of the typeface. |
| Description | 10 Description; description of the typeface. Can contain revision information, usage recommendations, history, features, and so on. |
| UrlVendor | 11 URL of the Font vendor (with procotol, e.g., http://, ftp://). If a unique serial number is embedded in the URL, it can be used to register the Font. |
| UrlDesigner | 12 URL of the Font designer (with protocol, e.g., http://, ftp://) |
| LicenseDescription | 13 License description; description of how the Font may be legally used, or different example scenarios for licensed use. This field should be written in plain language, not legalese. |
| LicenseInfoUrl | 14 License information URL, where additional licensing information can be found. |
| PreferredFamily | 15 Reserved 16 Preferred Family (Windows only); In Windows, the Family name is displayed in the Font menu; the Subfamily name is presented as the Style name. For historical reasons, Font families have contained a maximum of four styles, but Font designers may group more than four fonts to a single family. The Preferred Family and Preferred Subfamily IDs allow Font designers to include the preferred family/subfamily groupings. These IDs are only present if they are different from IDs 1 and 2. |
| PreferredSubfamily | 17 Preferred Subfamily (Windows only); In Windows, the Family name is displayed in the Font menu; the Subfamily name is presented as the Style name. For historical reasons, Font families have contained a maximum of four styles, but Font designers may group more than four fonts to a single family. The Preferred Family and Preferred Subfamily IDs allow Font designers to include the preferred family/subfamily groupings. These IDs are only present if they are different from IDs 1 and 2. |
| CompatibleFull | 18 Compatible Full (Macintosh only); On the Macintosh, the menu name is constructed using the Font resource. This usually matches the Full Name. If you want the name of the Font to appear differently than the Full Name, you can insert the Compatible Full Name in ID 18. This name is not used by the Mac OS itself, but may be used by application developers (e.g., Adobe). |
| SampleText | 19 Sample text. This can be the Font name, or any other text that the designer thinks is the best sample text to show what the Font looks like. |
| PostScriptCID | Its presence in a font means that the nameID 6 holds a PostScript font name that is meant to be used with the “composefont” invocation in order to invoke the font in a PostScript interpreter |
| WwsFamilyName | Used to provide a WWS-conformant family name in case the entries for IDs 16 and 17 do not conform to the WWS model |
| WwsSubfamilyName | Used in conjunction with ID 21, this ID provides a WWS-conformant subfamily name (reflecting only weight, width and slope attributes) in case the entries for IDs 16 and 17 do not conform to the WWS model |
| LightBackground | This ID, if used in the CPAL table’s Palette Labels Array, specifies that the corresponding color palette in the CPAL table is appropriate to use with the font when displaying it on a light background such as white |
| DarkBackground | This ID, if used in the CPAL table’s Palette Labels Array, specifies that the corresponding color palette in the CPAL table is appropriate to use with the font when displaying it on a dark background such as black |
| VariationsPostScriptNamePrefix | If present in a variable font, it may be used as the family prefix in the PostScript Name Generation for Variation Fonts algorithm |
◆ PlatformId
Represents PlatformId enumeration.
◆ UnicodePlatformSpecificId
Represents unicode platform-specific enumeration.
Constructor & Destructor Documentation
◆ TtfNameTable() [1/2]
|
protected |
Initializes a new instance of the TtfNameTable class.
- Parameters
-
ttfTables TTF tables repository. font TTF Font.
◆ TtfNameTable() [2/2]
|
protected |
◆ ~TtfNameTable()
|
protectedvirtual |
Member Function Documentation
◆ AddMultiLanguageNames()
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::AddMultiLanguageNames | ( | System::SharedPtr< MultiLanguageString > | mlNames, |
| TtfNameTable::PlatformId | platformId, | ||
| uint16_t | platformSpecificId, | ||
| TtfNameTable::NameId | nameId | ||
| ) |
Extracts all multilingual strings from passed mlNames object and creates correspondent NameRecord structure for every string extracted using passed parameters platformId , platformSpecificId and nameId . Value for field languageID is extracted from mlNames object. New just created record is added into table. If record which coincides with just created by fields platformID, platformSpecificID, nameID and, langugeId will be found, then new created record will not be added and only string data will be updated for existing record.
- Parameters
-
mlNames Multilingual string platformId Platform identifier platformSpecificId Platform-specific encoding identifier nameId Name identifier, logical string category, specified by NameId enumeration
◆ AddName()
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::AddName | ( | TtfNameTable::NameId | nameId, |
| TtfNameTable::PlatformId | platformId, | ||
| int32_t | platformSpecificId, | ||
| int32_t | languageId, | ||
| System::String | name | ||
| ) |
Adds entry into the table. String data category to add is specified by name parameter.
- Parameters
-
nameId Name identifier, logical string category, specified by NameId enumeration platformId Platform identifier platformSpecificId Platform-specific encoding identifier. Please, use value from one of such enumerations - UnicodePlatformSpecificId, MacPlatformSpecificId, MSPlatformSpecificId. What enumeration to use is defined by context (platformId parameter) languageId Language identifier. Please, use value from MSLanguageId or MacLanguageId enumerations depend from context, defined by platformId parameter. name Actual string data
◆ AddNameById()
|
protected |
Adds name by NameId.
- Parameters
-
nameId name identifier name name
◆ AssignDataFrom()
|
overrideprotectedvirtual |
Designed to copy data from another table with same type, for example hhea->hhea, hmtx->hmtx. This mechanism can be helpful when table of generated font needed to copy data from another existing font(not generated) to avoid problems with linking to data source(source table from existing font has link to data source(offset, length), but this link data is superfluous for destination table, so full copy (method like Copy()) is not decision for this case. Let the table takes necessary data via this assigning mechanism.
- Parameters
-
table table to get data from
Reimplemented from Aspose::Font::TtfTables::TtfTableBase.
◆ DeleteRecords() [1/3]
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::DeleteRecords | ( | TtfNameTable::PlatformId | platformId, |
| uint16_t | platformSpecificId, | ||
| TtfNameTable::NameId | nameId | ||
| ) |
Deletes all the records related to passed parameters
- Parameters
-
platformId Platform identifier platformSpecificId Platform-specific encoding identifier nameId Name identifier, logical string category, specified by NameId enumeration
◆ DeleteRecords() [2/3]
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::DeleteRecords | ( | TtfNameTable::PlatformId | platformId, |
| uint16_t | platformSpecificId | ||
| ) |
Deletes all the records related to platform specified
- Parameters
-
platformId Platform identifier platformSpecificId Platform-specific encoding identifier
◆ DeleteRecords() [3/3]
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::DeleteRecords | ( | TtfNameTable::PlatformId | platformId, |
| uint16_t | platformSpecificId, | ||
| TtfNameTable::NameId | nameId, | ||
| uint16_t | languageId | ||
| ) |
Deletes record(s) related to parameters specified
- Parameters
-
platformId Platform identifier platformSpecificId Platform-specific encoding identifier nameId Name identifier, logical string category, specified by NameId enumeration languageId Language identifier
◆ DeleteRecordsByNameId()
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::DeleteRecordsByNameId | ( | TtfNameTable::NameId | nameId | ) |
Deletes all the records related to passed nameId parameter
- Parameters
-
nameId Name identifier, logical string category, specified by NameId enumeration
◆ get_SaveRecordsWithEmptyString()
|
protected |
Flag for saving NameRecords with empty property 'String'
◆ get_Tag()
|
static |
Gets table tag.
◆ GetAllNameRecords()
| ASPOSE_FONT_SHARED_API System::ArrayPtr<System::SharedPtr<TtfNameTable::NameRecord> > Aspose::Font::TtfTables::TtfNameTable::GetAllNameRecords | ( | ) |
Returns all NameRecord structures from table
- Returns
- Array of NameRecord structures
◆ GetMultiLanguageNameById() [1/3]
| ASPOSE_FONT_SHARED_API System::SharedPtr<MultiLanguageString> Aspose::Font::TtfTables::TtfNameTable::GetMultiLanguageNameById | ( | TtfNameTable::NameId | nameId | ) |
Returns a name by nameId.
- Parameters
-
nameId Name Id.
- Returns
- Name.
◆ GetMultiLanguageNameById() [2/3]
| ASPOSE_FONT_SHARED_API System::SharedPtr<MultiLanguageString> Aspose::Font::TtfTables::TtfNameTable::GetMultiLanguageNameById | ( | TtfNameTable::NameId | nameId, |
| TtfNameTable::PlatformId | platformId | ||
| ) |
Returns a name by nameId using platform identifier passed.
- Parameters
-
nameId Name Id. platformId Platform Id.
- Returns
- Name.
◆ GetMultiLanguageNameById() [3/3]
| ASPOSE_FONT_SHARED_API System::SharedPtr<MultiLanguageString> Aspose::Font::TtfTables::TtfNameTable::GetMultiLanguageNameById | ( | TtfNameTable::NameId | nameId, |
| TtfNameTable::PlatformId | platformId, | ||
| uint16_t | platformSpecificId | ||
| ) |
Returns a name as object of type MultiLanguageString. Method collects all NameRecord structures which coincide with passed parameters nameId, platformId and platformSpecificId and then builds resultant object based on this structures list.
- Parameters
-
nameId Name Id. platformId Platform Id. platformSpecificId Platform specific Id.
- Returns
- Name.
◆ GetNameById()
| ASPOSE_FONT_SHARED_API System::String Aspose::Font::TtfTables::TtfNameTable::GetNameById | ( | TtfNameTable::NameId | nameId | ) |
Returns a name by nameId if found, null otherwise
- Parameters
-
nameId name identifier
- Returns
- name
◆ GetNameRecordsByNameId()
| ASPOSE_FONT_SHARED_API System::ArrayPtr<System::SharedPtr<TtfNameTable::NameRecord> > Aspose::Font::TtfTables::TtfNameTable::GetNameRecordsByNameId | ( | TtfNameTable::NameId | nameId | ) |
Returns all NameRecord structures which NameId field is equal to passed nameId value. If no records found, empty array will be returned.
- Parameters
-
nameId name identifier
- Returns
- Array of NameRecord structures
◆ Load()
|
overrideprotectedvirtual |
Loads current table
Reimplemented from Aspose::Font::TtfTables::TtfTableBase.
◆ MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION() [1/2]
|
protected |
◆ MEMBER_FUNCTION_MAKE_OBJECT_DECLARATION() [2/2]
|
protected |
◆ Save()
|
overrideprotectedvirtual |
Saves the table to font stream
base mathod implementation simply retrieves initial table data
Reimplemented from Aspose::Font::TtfTables::TtfTableBase.
◆ set_SaveRecordsWithEmptyString()
|
protected |
Flag for saving NameRecords with empty property 'String'
◆ UpdateName()
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::UpdateName | ( | TtfNameTable::PlatformId | platformId, |
| uint16_t | platformSpecificId, | ||
| TtfNameTable::NameId | nameId, | ||
| uint16_t | languageId, | ||
| System::String | newName | ||
| ) |
Updates name in record(s) which related to specified platform (combination of platformId and platformSpecificId), category (nameId) and language (languageId).
- Parameters
-
platformId Platform identifier platformSpecificId Platform-specific encoding identifier nameId Name identifier, logical string category, specified by NameId enumeration languageId Language identifier newName New name or new string data
◆ UpdateNamesByNameId()
| ASPOSE_FONT_SHARED_API void Aspose::Font::TtfTables::TtfNameTable::UpdateNamesByNameId | ( | TtfNameTable::NameId | nameId, |
| System::String | newName | ||
| ) |
Selects all records which related to logical string category, specified by parameter nameId and updates name field (string data) in these records. Fields related to platform (platformID, Platform-specific encoding ID) and language (Language ID) are not affected by this method. Only name string data is replaced with a new name. Use this method with caution, cause it will replace original names for all platforms and languages, related to nameId. It can make a conflicts for cases when original names had different values, cause replace operation changes all these values with new single one.And this new value may have a logical inconsistency with some platforms and languages. This method is useful for cases when original name has single representation for all platforms and languages, for example, when name string data is in english language.
- Parameters
-
nameId Name identifier, logical string category, specified by NameId enumeration newName New name or new string data
Member Data Documentation
◆ LowerTag
|
staticprotected |
◆ NameChanged
|
protected |
◆ TAG
|
staticprotected |
Table Tag.