File: SCREENTextModes.c

package info (click to toggle)
psychtoolbox-3 3.0.19.14.dfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 86,796 kB
  • sloc: ansic: 176,245; cpp: 20,103; objc: 5,393; sh: 2,753; python: 1,397; php: 384; makefile: 193; java: 113
file content (59 lines) | stat: -rw-r--r-- 1,871 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/*
	SCREENTextModes.c	
  
	AUTHORS:
  
		Allen.Ingling@nyu.edu			awi
  		mario.kleiner@tuebingen.mpg.de	mk

	PLATFORMS:
  
		All.
    
	HISTORY:
  
		11/17/03	awi		Wrote it.
		10/12/04	awi		Changed "SCREEN" to "Screen" in useString.

   
	DESCRIPTION:
  
		Text Modes are things like 'TextFill', 'TextStroke', 'TextFillStroke', 'TextInvisible', 'FillClip',    
		'StrokeClip', 'TextFillStrokeClip' and 'TextClip'.  They are not properites of the font but characterstics
		of how the font is rendered. 
  
	NOTES:

*/


#include "Screen.h"

// If you change useString then also change the corresponding synopsis string in ScreenSynopsis.c
static char useString[] = "textModes = Screen('TextModes');";
static char synopsisString[] =	"Return a cell array of strings naming allowable text modes for Screen('TextMode').\n"
								"Please note that none of these modes are supported in the current Psychtoolbox, "
                                "except on OSX with its default text renderer 1 aka the Apple CoreText renderer, "
								"so whatever 'TextMode' you set will be silently ignored and have no effect. ";
static char seeAlsoString[] = "TextMode";

PsychError SCREENTextModes(void) 
{
    int							i;
    PsychGenericScriptType		*cellVector;

    //all subfunctions should have these two lines.  
    PsychPushHelp(useString, synopsisString, seeAlsoString);
    if(PsychIsGiveHelp()){PsychGiveHelp();return(PsychError_none);};
    
    //check for valid number of arguments
    PsychErrorExit(PsychCapNumInputArgs(0));   	
    PsychErrorExit(PsychCapNumOutputArgs(1)); 
    
    //generate a cell array to return
    PsychAllocOutCellVector(1, FALSE, kPsychNumTextDrawingModes,  &cellVector);
    for(i=0;i<kPsychNumTextDrawingModes;i++)
        PsychSetCellVectorStringElement(i, PsychTextDrawingModeNames[i], cellVector);
        
    return(PsychError_none);
}