ON_PANOSE1 Class Reference

https://monotype.github.io/panose/pan1.htm More...

#include <opennurbs_font.h>

Public Types
enum	FamilyKind : ON__UINT8 {   FamilyKind::Any = 0, FamilyKind::NoFit = 1, FamilyKind::LatinText = 2, FamilyKind::LatinScript = 3,   FamilyKind::LatinDecorative = 4, FamilyKind::LatinSymbol = 5 }
	PANOSE 1.0 font family kind More...

Public Member Functions
	ON_PANOSE1 ()=default
	ON_PANOSE1 (const ON_PANOSE1 &)=default
	~ON_PANOSE1 ()=default
void	Dump (class ON_TextLog &text_log) const
bool	IsSet () const
bool	IsZero () const
bool	IsZeroOrOne () const
ON_PANOSE1 &	operator= (const ON_PANOSE1 &)=default
ON_PANOSE1::FamilyKind	PANOSE1FamilyKind () const
bool	Read (class ON_BinaryArchive &archive)
void	SetNineBytes (ON_PANOSE1::FamilyKind family_kind, const ON__UINT8 *panose1_properties_bytes)
void	SetTenBytes (const ON__UINT8 *panose1_ten_bytes)
const ON__UINT8 *	TenBytes () const
bool	Write (class ON_BinaryArchive &archive) const

Static Public Member Functions
static ON_PANOSE1::FamilyKind	FamilyKindFromUnsigned (unsigned int unsigned_panose_family_kind)
static const wchar_t *	FamilyKindToWideString (ON_PANOSE1::FamilyKind family_kind)

Static Public Attributes
static const ON_PANOSE1	Zero
	All PANOSE 1.0 values are zero, which means (Any,Any,...,Any) More...

Detailed Description

https://monotype.github.io/panose/pan1.htm

Copyright (c) 1993-2022 Robert McNeel & Associates. All rights reserved. OpenNURBS, Rhinoceros, and Rhino3D are registered trademarks of Robert McNeel & Associates.

THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR PURPOSE AND OF MERCHANTABILITY ARE HEREBY DISCLAIMED.

For complete openNURBS copyright information see http://www.opennurbs.org.

Member Enumeration Documentation

FamilyKind

enum ON_PANOSE1::FamilyKind : ON__UINT8

strong

PANOSE 1.0 font family kind

The overall genre of the alphabet or script that is being described is signified by the Family Kind digit. This digit consists of two parts: the script kind identifier and the genre kind identifier. In this case, the script identifier is Latin, and the genre type is described as Text, Hand Written, Decorative or Symbol. The Family Kind digit is not controlled by specific measurements, and there has been no attempt to mathematically determine the appropriate category for a given font design. Visual and aesthetic classification of Latin faces that are obviously script, decorative, or symbol fonts is required.

Enumerator
Any	"Any" means match that digit with any available digit, which allows the mapper to handle distortable typefaces.
NoFit	"No Fit" means that the item being classified does not fit within the PANOSE 1.0 classification system.
LatinText	To decide whether a font belongs to the Latin Text group follow the two step process below. A. Answer the following three questions. If they are all yes, then it belongs in this group. If the answer is still ambiguous, go to step B. Does the font belong to a family that includes italic versions? Most fonts in this group have a variety of weights and most include italic versions. Are the characters in the font made up of standard topologies constructed of standard parts? Is some portion of the font suitable for composing a paragraph of text? B. As a final tie breaker, look at the second digit of the Decorative (Section 4) and Handwritten (Section 3) families and see if there is something in them that fits the font in question better. https://monotype.github.io/panose/pan2.htm
LatinScript	Many fonts are clearly scripts and unrelated to any book face. On occasion, though, the distinction gets rather vague. A good rule of thumb is that if the cursive font is part a family that includes a book face, then it should be classified in the Latin Text group. If it is freestanding with no obvious related book face, then it falls into the Latin Hand Written group. This can be a bit difficult to determine, since a font house may only choose to provide the cursive from a larger family, so the classifier needs to think about the face being processed and not do it purely by rote. https://monotype.github.io/panose/pan3.htm
LatinDecorative	Latin Decorative faces are those that are designed more for impact than readability. Usually Decoratives are used singly or in small groups, for special purposes. Small cap fonts are also included in this group because they have become unusual enough to be considered special purpose fonts. https://monotype.github.io/panose/pan4.htm
LatinSymbol	Latin Symbol is where all the nonalphabetic fonts reside. These are fonts that can be loaded like normal text fonts, but do not contain readable characters. Dingbats and specialized symbol fonts are two examples. https://monotype.github.io/panose/pan5.htm

Constructor & Destructor Documentation

ON_PANOSE1() [1/2]

ON_PANOSE1::ON_PANOSE1 ( )

default

~ON_PANOSE1()

ON_PANOSE1::~ON_PANOSE1 ( )

default

ON_PANOSE1() [2/2]

ON_PANOSE1::ON_PANOSE1 ( const ON_PANOSE1 &  )

default

Member Function Documentation

Dump()

void ON_PANOSE1::Dump

(

class ON_TextLog &

text_log

)

const

FamilyKindFromUnsigned()

static ON_PANOSE1::FamilyKind ON_PANOSE1::FamilyKindFromUnsigned ( unsigned int  unsigned_panose_family_kind )

static

Special values "Any" (0) and "No Fit" (1) exist for every category, which have specific meanings to the mapper.
Description: In the rare cases when an ON_PANOSE1::Classification value must be passed as an unsigned int, use ON_PANOSE1::ClassificationFromUnsigned() to convert the unsigned value to an ON_PANOSE1::Classification value. Parameters: unsigned_panose_family_kind - [in]

FamilyKindToWideString()

static const wchar_t* ON_PANOSE1::FamilyKindToWideString ( ON_PANOSE1::FamilyKind  family_kind )

static

IsSet()

bool ON_PANOSE1::IsSet

(

)

const

Returns: True if some PANOSE 1.0 value is not zero and not one. This means this PANOSE 1.0 information may be useful in searching for similar fonts.

IsZero()

bool ON_PANOSE1::IsZero

(

)

const

Returns: True if every PANOSE 1.0 value is zero which means there is no useful font classification information in the instance.

IsZeroOrOne()

bool ON_PANOSE1::IsZeroOrOne

(

)

const

Returns: True if every PANOSE 1.0 value is zero or one which means there is no useful font classification information in the instance.

operator=()

ON_PANOSE1& ON_PANOSE1::operator= ( const ON_PANOSE1 &  )

default

PANOSE1FamilyKind()

ON_PANOSE1::FamilyKind ON_PANOSE1::PANOSE1FamilyKind

(

)

const

Read()

bool ON_PANOSE1::Read

(

class ON_BinaryArchive &

archive

)

SetNineBytes()

void ON_PANOSE1::SetNineBytes	(	ON_PANOSE1::FamilyKind	family_kind,
		const ON__UINT8 *	panose1_properties_bytes
	)

Parameters: family_kind - [in] PANOSE 1.0 font Family kind classification panose1_properties_bytes - [in] Array of 9 bytes of PANOSE1 properties

SetTenBytes()

void ON_PANOSE1::SetTenBytes

(

const ON__UINT8 *

panose1_ten_bytes

)

Parameters: classification - [in] PANOSE 1.0 font classification panose1_properties_bytes - [in] Array of 9 bytes of PANOSE1 properties

TenBytes()

const ON__UINT8* ON_PANOSE1::TenBytes

(

)

const

Returns: A pointer to an array of 10 bytes of PANOSE 1 classification properties. The initial byte is the PANOSE 1 Classification and is identical to the value returned by FontClassification(). The interpretation of the following 9 bytes depends on the value of the first byte. If the initial byte is 0 = ON_FontPANOSE1::Classification::Any (0) or 1 = ON_FontPANOSE1::Classification::NoFit, then these 9 bytes have no meaning.

Write()

bool ON_PANOSE1::Write

(

class ON_BinaryArchive &

archive

)

const

Member Data Documentation

Zero

const ON_PANOSE1 ON_PANOSE1::Zero

static

All PANOSE 1.0 values are zero, which means (Any,Any,...,Any)