ref: 6043b2404efc77a1c0dc09a193a6526a62e55e28
dir: /src/truetype/ttobjs.c/
/***************************************************************************/ /* */ /* ttobjs.c */ /* */ /* Objects manager (body). */ /* */ /* Copyright 1996-2000 by */ /* David Turner, Robert Wilhelm, and Werner Lemberg. */ /* */ /* This file is part of the FreeType project, and may only be used, */ /* modified, and distributed under the terms of the FreeType project */ /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ /* this file you indicate that you have read the license and */ /* understand and accept it fully. */ /* */ /***************************************************************************/ #include <freetype/internal/ftdebug.h> #include <freetype/internal/ftcalc.h> #include <freetype/internal/ftstream.h> #include <freetype/ttnameid.h> #include <freetype/tttags.h> #include <freetype/internal/sfnt.h> #include <freetype/internal/psnames.h> #ifdef FT_FLAT_COMPILE #include "ttgload.h" #include "ttpload.h" #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER #include "ttinterp.h" #endif #else /* FT_FLAT_COMPILE */ #include <truetype/ttgload.h> #include <truetype/ttpload.h> #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER #include <truetype/ttinterp.h> #endif #endif /* FT_FLAT_COMPILE */ #include <freetype/internal/tterrors.h> /*************************************************************************/ /* */ /* The macro FT_COMPONENT is used in trace mode. It is an implicit */ /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log */ /* messages during execution. */ /* */ #undef FT_COMPONENT #define FT_COMPONENT trace_ttobjs #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER /*************************************************************************/ /* */ /* GLYPH ZONE FUNCTIONS */ /* */ /*************************************************************************/ /*************************************************************************/ /* */ /* <Function> */ /* TT_Done_GlyphZone */ /* */ /* <Description> */ /* Deallocates a glyph zone. */ /* */ /* <Input> */ /* zone :: A pointer to the target glyph zone. */ /* */ LOCAL_FUNC void TT_Done_GlyphZone( TT_GlyphZone* zone ) { FT_Memory memory = zone->memory; FREE( zone->contours ); FREE( zone->tags ); FREE( zone->cur ); FREE( zone->org ); zone->max_points = zone->n_points = 0; zone->max_contours = zone->n_contours = 0; } /*************************************************************************/ /* */ /* <Function> */ /* TT_New_GlyphZone */ /* */ /* <Description> */ /* Allocates a new glyph zone. */ /* */ /* <Input> */ /* memory :: A handle to the current memory object. */ /* */ /* maxPoints :: The capacity of glyph zone in points. */ /* */ /* maxContours :: The capacity of glyph zone in contours. */ /* */ /* <Output> */ /* zone :: A pointer to the target glyph zone record. */ /* */ /* <Return> */ /* FreeType error code. 0 means success. */ /* */ LOCAL_FUNC FT_Error TT_New_GlyphZone( FT_Memory memory, FT_UShort maxPoints, FT_Short maxContours, TT_GlyphZone* zone ) { FT_Error error; if ( maxPoints > 0 ) maxPoints += 2; MEM_Set( zone, 0, sizeof ( *zone ) ); zone->memory = memory; if ( ALLOC_ARRAY( zone->org, maxPoints * 2, FT_F26Dot6 ) || ALLOC_ARRAY( zone->cur, maxPoints * 2, FT_F26Dot6 ) || ALLOC_ARRAY( zone->tags, maxPoints, FT_Byte ) || ALLOC_ARRAY( zone->contours, maxContours, FT_UShort ) ) { TT_Done_GlyphZone( zone ); } return error; } #endif /* TT_CONFIG_OPTION_BYTECODE_INTERPRETER */ /*************************************************************************/ /* */ /* <Function> */ /* TT_Init_Face */ /* */ /* <Description> */ /* Initializes a given TrueType face object. */ /* */ /* <Input> */ /* stream :: The source font stream. */ /* */ /* face_index :: The index of the font face in the resource. */ /* */ /* num_params :: Number of additional generic parameters. Ignored. */ /* */ /* params :: Additional generic parameters. Ignored. */ /* */ /* <InOut> */ /* face :: The newly built face object. */ /* */ /* <Return> */ /* FreeType error code. 0 means success. */ /* */ LOCAL_DEF FT_Error TT_Init_Face( FT_Stream stream, TT_Face face, FT_Int face_index, FT_Int num_params, FT_Parameter* params ) { FT_Error error; FT_Library library; SFNT_Interface* sfnt; library = face->root.driver->root.library; sfnt = (SFNT_Interface*)FT_Get_Module_Interface( library, "sfnt" ); if ( !sfnt ) goto Bad_Format; /* create input stream from resource */ if ( FILE_Seek( 0 ) ) goto Exit; /* check that we have a valid TrueType file */ error = sfnt->init_face( stream, face, face_index, num_params, params ); if ( error ) goto Exit; /* We must also be able to accept Mac/GX fonts, as well as OT ones */ if ( face->format_tag != 0x00010000L && /* MS fonts */ face->format_tag != TTAG_true ) /* Mac fonts */ { FT_TRACE2(( "[not a valid TTF font]\n" )); goto Bad_Format; } /* If we are performing a simple font format check, exit immediately */ if ( face_index < 0 ) return TT_Err_Ok; /* Load font directory */ error = sfnt->load_face( stream, face, face_index, num_params, params ); if ( error ) goto Exit; if ( face->root.face_flags & FT_FACE_FLAG_SCALABLE ) error = TT_Load_Locations( face, stream ) || TT_Load_CVT ( face, stream ) || TT_Load_Programs ( face, stream ); /* initialize standard glyph loading routines */ TT_Init_Glyph_Loading( face ); Exit: return error; Bad_Format: error = FT_Err_Unknown_File_Format; goto Exit; } /*************************************************************************/ /* */ /* <Function> */ /* TT_Done_Face */ /* */ /* <Description> */ /* Finalizes a given face object. */ /* */ /* <Input> */ /* face :: A pointer to the face object to destroy. */ /* */ LOCAL_DEF void TT_Done_Face( TT_Face face ) { FT_Memory memory = face->root.memory; FT_Stream stream = face->root.stream; SFNT_Interface* sfnt = (SFNT_Interface*)face->sfnt; /* for `extended TrueType formats' (i.e. compressed versions) */ if ( face->extra.finalizer ) face->extra.finalizer( face->extra.data ); if ( sfnt ) sfnt->done_face( face ); /* freeing the locations table */ FREE( face->glyph_locations ); face->num_locations = 0; /* freeing the CVT */ FREE( face->cvt ); face->cvt_size = 0; /* freeing the programs */ RELEASE_Frame( face->font_program ); RELEASE_Frame( face->cvt_program ); face->font_program_size = 0; face->cvt_program_size = 0; } /*************************************************************************/ /* */ /* SIZE FUNCTIONS */ /* */ /*************************************************************************/ /*************************************************************************/ /* */ /* <Function> */ /* TT_Init_Size */ /* */ /* <Description> */ /* Initializes a new TrueType size object. */ /* */ /* <InOut> */ /* size :: A handle to the size object. */ /* */ /* <Return> */ /* FreeType error code. 0 means success. */ /* */ LOCAL_DEF FT_Error TT_Init_Size( TT_Size size ) { FT_Error error = TT_Err_Ok; #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER TT_Face face = (TT_Face)size->root.face; FT_Memory memory = face->root.memory; FT_Int i; TT_ExecContext exec; FT_UShort n_twilight; TT_MaxProfile* maxp = &face->max_profile; size->ttmetrics.valid = FALSE; size->max_function_defs = maxp->maxFunctionDefs; size->max_instruction_defs = maxp->maxInstructionDefs; size->num_function_defs = 0; size->num_instruction_defs = 0; size->max_func = 0; size->max_ins = 0; size->cvt_size = face->cvt_size; size->storage_size = maxp->maxStorage; /* Set default metrics */ { FT_Size_Metrics* metrics = &size->root.metrics; TT_Size_Metrics* metrics2 = &size->ttmetrics; metrics->x_ppem = 0; metrics->y_ppem = 0; metrics2->rotated = FALSE; metrics2->stretched = FALSE; /* set default compensation (all 0) */ for ( i = 0; i < 4; i++ ) metrics2->compensations[i] = 0; } /* allocate function defs, instruction defs, cvt, and storage area */ if ( ALLOC_ARRAY( size->function_defs, size->max_function_defs, TT_DefRecord ) || ALLOC_ARRAY( size->instruction_defs, size->max_instruction_defs, TT_DefRecord ) || ALLOC_ARRAY( size->cvt, size->cvt_size, FT_Long ) || ALLOC_ARRAY( size->storage, size->storage_size, FT_Long ) ) goto Fail_Memory; /* reserve twilight zone */ n_twilight = maxp->maxTwilightPoints; error = TT_New_GlyphZone( memory, n_twilight, 0, &size->twilight ); if ( error ) goto Fail_Memory; size->twilight.n_points = n_twilight; /* set `face->interpreter' according to the debug hook present */ { FT_Library library = face->root.driver->root.library; face->interpreter = (TT_Interpreter) library->debug_hooks[FT_DEBUG_HOOK_TRUETYPE]; if ( !face->interpreter ) face->interpreter = (TT_Interpreter)TT_RunIns; } /* Fine, now execute the font program! */ exec = size->context; /* size objects used during debugging have their own context */ if ( !size->debug ) exec = TT_New_Context( face ); if ( !exec ) { error = TT_Err_Could_Not_Find_Context; goto Fail_Memory; } size->GS = tt_default_graphics_state; TT_Load_Context( exec, face, size ); exec->callTop = 0; exec->top = 0; exec->period = 64; exec->phase = 0; exec->threshold = 0; { FT_Size_Metrics* metrics = &exec->metrics; TT_Size_Metrics* tt_metrics = &exec->tt_metrics; metrics->x_ppem = 0; metrics->y_ppem = 0; metrics->x_scale = 0; metrics->y_scale = 0; tt_metrics->ppem = 0; tt_metrics->scale = 0; tt_metrics->ratio = 0x10000L; } exec->instruction_trap = FALSE; exec->cvtSize = size->cvt_size; exec->cvt = size->cvt; exec->F_dot_P = 0x10000L; /* allow font program execution */ TT_Set_CodeRange( exec, tt_coderange_font, face->font_program, face->font_program_size ); /* disable CVT and glyph programs coderange */ TT_Clear_CodeRange( exec, tt_coderange_cvt ); TT_Clear_CodeRange( exec, tt_coderange_glyph ); if ( face->font_program_size > 0 ) { error = TT_Goto_CodeRange( exec, tt_coderange_font, 0 ); if ( !error ) error = face->interpreter( exec ); if ( error ) goto Fail_Exec; } else error = TT_Err_Ok; TT_Save_Context( exec, size ); if ( !size->debug ) TT_Done_Context( exec ); #endif /* TT_CONFIG_OPTION_BYTECODE_INTERPRETER */ size->ttmetrics.valid = FALSE; return error; #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER Fail_Exec: if ( !size->debug ) TT_Done_Context( exec ); Fail_Memory: TT_Done_Size( size ); return error; #endif /* TT_CONFIG_OPTION_BYTECODE_INTERPRETER */ } /*************************************************************************/ /* */ /* <Function> */ /* TT_Done_Size */ /* */ /* <Description> */ /* The TrueType size object finalizer. */ /* */ /* <Input> */ /* size :: A handle to the target size object. */ /* */ LOCAL_FUNC void TT_Done_Size( TT_Size size ) { #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER FT_Memory memory = size->root.face->memory; if ( size->debug ) { /* the debug context must be deleted by the debugger itself */ size->context = NULL; size->debug = FALSE; } FREE( size->cvt ); size->cvt_size = 0; /* free storage area */ FREE( size->storage ); size->storage_size = 0; /* twilight zone */ TT_Done_GlyphZone( &size->twilight ); FREE( size->function_defs ); FREE( size->instruction_defs ); size->num_function_defs = 0; size->max_function_defs = 0; size->num_instruction_defs = 0; size->max_instruction_defs = 0; size->max_func = 0; size->max_ins = 0; #endif size->ttmetrics.valid = FALSE; } /*************************************************************************/ /* */ /* <Function> */ /* TT_Reset_Size */ /* */ /* <Description> */ /* Resets a TrueType size when resolutions and character dimensions */ /* have been changed. */ /* */ /* <Input> */ /* size :: A handle to the target size object. */ /* */ LOCAL_DEF FT_Error TT_Reset_Size( TT_Size size ) { TT_Face face; FT_Error error = TT_Err_Ok; FT_Size_Metrics* metrics; if ( size->ttmetrics.valid ) return TT_Err_Ok; face = (TT_Face)size->root.face; metrics = &size->root.metrics; if ( metrics->x_ppem < 1 || metrics->y_ppem < 1 ) return TT_Err_Invalid_PPem; /* compute new transformation */ if ( metrics->x_ppem >= metrics->y_ppem ) { size->ttmetrics.scale = metrics->x_scale; size->ttmetrics.ppem = metrics->x_ppem; size->ttmetrics.x_ratio = 0x10000L; size->ttmetrics.y_ratio = FT_MulDiv( metrics->y_ppem, 0x10000L, metrics->x_ppem ); } else { size->ttmetrics.scale = metrics->y_scale; size->ttmetrics.ppem = metrics->y_ppem; size->ttmetrics.x_ratio = FT_MulDiv( metrics->x_ppem, 0x10000L, metrics->y_ppem ); size->ttmetrics.y_ratio = 0x10000L; } /* Compute root ascender, descender, test height, and max_advance */ #ifdef TT_CONFIG_OPTION_EMBEDDED_BITMAPS if ( ( !( face->root.face_flags & FT_FACE_FLAG_SCALABLE ) && ( face->root.face_flags & FT_FACE_FLAG_FIXED_SIZES ) ) ) { FT_Int i; for ( i = 0; i < face->root.num_fixed_sizes; i++ ) { if ( ( face->sbit_strikes[i].x_ppem == metrics->x_ppem ) && ( face->sbit_strikes[i].y_ppem == metrics->y_ppem ) ) { /* * XXX: We now set horizontal metrics, * but this is not valid if we use vertical layout style */ metrics->ascender = face->sbit_strikes[i].hori.ascender * 64; metrics->descender = face->sbit_strikes[i].hori.descender * 64; metrics->height = ( face->sbit_strikes[i].hori.ascender - face->sbit_strikes[i].hori.descender ) * 64; /* XXX: Is this correct? */ metrics->max_advance = ( face->sbit_strikes[i].hori.min_origin_SB + face->sbit_strikes[i].hori.max_width + face->sbit_strikes[i].hori.min_advance_SB ) * 64; break; } } if ( i == face->root.num_fixed_sizes ) return TT_Err_Invalid_PPem; } else #endif /* TT_CONFIG_OPTION_EMBEDDED_BITMAPS */ { metrics->ascender = ( FT_MulFix( face->root.ascender, metrics->y_scale ) + 32 ) & -64; metrics->descender = ( FT_MulFix( face->root.descender, metrics->y_scale ) + 32 ) & -64; metrics->height = ( FT_MulFix( face->root.height, metrics->y_scale ) + 32 ) & -64; metrics->max_advance = ( FT_MulFix( face->root.max_advance_width, metrics->x_scale ) + 32 ) & -64; } #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER { TT_ExecContext exec; FT_UInt i, j; /* Scale the cvt values to the new ppem. */ /* We use by default the y ppem to scale the CVT. */ for ( i = 0; i < size->cvt_size; i++ ) size->cvt[i] = FT_MulFix( face->cvt[i], size->ttmetrics.scale ); /* All twilight points are originally zero */ for ( j = 0; j < size->twilight.n_points; j++ ) { size->twilight.org[j].x = 0; size->twilight.org[j].y = 0; size->twilight.cur[j].x = 0; size->twilight.cur[j].y = 0; } /* clear storage area */ for ( i = 0; i < size->storage_size; i++ ) size->storage[i] = 0; size->GS = tt_default_graphics_state; /* get execution context and run prep program */ if ( size->debug ) exec = size->context; else exec = TT_New_Context( face ); /* debugging instances have their own context */ if ( !exec ) return TT_Err_Could_Not_Find_Context; TT_Load_Context( exec, face, size ); TT_Set_CodeRange( exec, tt_coderange_cvt, face->cvt_program, face->cvt_program_size ); TT_Clear_CodeRange( exec, tt_coderange_glyph ); exec->instruction_trap = FALSE; exec->top = 0; exec->callTop = 0; if ( face->cvt_program_size > 0 ) { error = TT_Goto_CodeRange( exec, tt_coderange_cvt, 0 ); if ( error ) goto End; if ( !size->debug ) error = face->interpreter( exec ); } else error = TT_Err_Ok; size->GS = exec->GS; /* save default graphics state */ End: TT_Save_Context( exec, size ); if ( !size->debug ) TT_Done_Context( exec ); /* debugging instances keep their context */ } #endif /* TT_CONFIG_OPTION_BYTECODE_INTERPRETER */ if ( !error ) size->ttmetrics.valid = TRUE; return error; } /*************************************************************************/ /* */ /* <Function> */ /* TT_Init_Driver */ /* */ /* <Description> */ /* Initializes a given TrueType driver object. */ /* */ /* <Input> */ /* driver :: A handle to the target driver object. */ /* */ /* <Return> */ /* FreeType error code. 0 means success. */ /* */ LOCAL_FUNC FT_Error TT_Init_Driver( TT_Driver driver ) { FT_Error error; /* set `extra' in glyph loader */ error = FT_GlyphLoader_Create_Extra( FT_DRIVER( driver )->glyph_loader ); /* init extension registry if needed */ #ifdef TT_CONFIG_OPTION_EXTEND_ENGINE if ( !error ) return TT_Init_Extensions( driver ); #endif return error; } /*************************************************************************/ /* */ /* <Function> */ /* TT_Done_Driver */ /* */ /* <Description> */ /* Finalizes a given TrueType driver. */ /* */ /* <Input> */ /* driver :: A handle to the target TrueType driver. */ /* */ LOCAL_FUNC void TT_Done_Driver( TT_Driver driver ) { /* destroy extensions registry if needed */ #ifdef TT_CONFIG_OPTION_EXTEND_ENGINE TT_Done_Extensions( driver ); #endif #ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER /* destroy the execution context */ if ( driver->context ) { TT_Destroy_Context( driver->context, driver->root.root.memory ); driver->context = NULL; } #else FT_UNUSED( driver ); #endif } /* END */