OsSetFontName

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Added description and additional information)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''Function Syntax:''' osSetFontName(string drawList, string fontName);<br>'''Returns:''' string  
+
{{osslfunc
 
+
|threat_level=ignored
Example Required&nbsp;!<br>  
+
|permissions=true
 
+
|delay=0
[[Category:OSSL]][[Category:OSSL_functions_without_example]]
+
|function_syntax=string osSetFontName(string drawList, string fontName)
[[Category:OSSL functions without threat level]]
+
|ossl_example=<source lang = "lsl">
 +
// ----------------------------------------------------------------
 +
// Example / Sample Script to show function use.
 +
//
 +
// Script Title:   osSetFontName_osSetFontSize.lsl
 +
// Script Author:
 +
// Threat Level:    None
 +
// Script Source:  SUPPLEMENTAL http://opensimulator.org/wiki/osSetFontName
 +
//                  SUPPLEMENTAL http://opensimulator.org/wiki/osSetFontSize
 +
//
 +
// Notes: See Script Source reference for more detailed information
 +
// This sample is full opensource and available to use as you see fit and desire.
 +
// Threat Levels only apply to OSSL & AA Functions
 +
// See http://opensimulator.org/wiki/Threat_level
 +
// ================================================================
 +
// C# Source Line:      public string osSetFontName(string drawList, string fontName)
 +
// C# Source Line:      public string osSetFontSize(string drawList, int fontSize)
 +
// Inworld Script Line: osSetFontName(string sCommandList, string sFontName);
 +
// Inworld Script Line: osSetFontSize(string sCommandList, integer iFontSize);
 +
//
 +
// Example of osSetFontName & osSetFontSize
 +
//
 +
// Example of osDrawText - Highlighting osSetFontName & osSetFontSize
 +
// For font families which can be used SEE:  http://www.w3schools.com/css/css_websafe_fonts.asp
 +
//
 +
integer iFlag = TRUE;
 +
string sCommandList = "";  // Storage for our drawing commands
 +
string sFontName = "Arial"; // Arial is the default font used, if unspecified
 +
integer iFontSize = 14;    // default to 24 point for sample
 +
integer iX = 10;            // used for osMovePen (X coord) from Top Left In
 +
integer iY = 10;            // used for osMovePen (Y coord) from Top Left Down
 +
string sText;
 +
//
 +
DrawText()
 +
{
 +
    sCommandList = osSetFontName(sCommandList, sFontName);
 +
    sCommandList = osSetFontSize(sCommandList, iFontSize);
 +
    sCommandList = osMovePen( sCommandList, iX, iY );      // Upper left corner at <pixels in, pixels down>
 +
    sCommandList = osDrawText( sCommandList, sText);        // The Text to Display
 +
    // Now draw the image
 +
    llWhisper(0,"FontName = "+sFontName+" FontSize = "+(string)iFontSize);
 +
    osSetDynamicTextureData( "", "vector", sCommandList, "width:512,height:512", 0 );
 +
}
 +
default
 +
{
 +
    state_entry()
 +
    {
 +
        llSay(0, "Touch to see how changing osSetFontName & osSetFontName work");
 +
        sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
 +
        DrawText();
 +
    }
 +
    touch_start(integer num)
 +
    {
 +
        if(iFlag)
 +
        {
 +
            iX = 10;
 +
            iY = 50;
 +
            iFlag = FALSE;
 +
            sFontName = "Times";
 +
            iFontSize = 18;
 +
            sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
 +
            DrawText();
 +
        }
 +
        else
 +
        {
 +
            iX = 10;
 +
            iY = 100;
 +
            iFlag = TRUE;
 +
            sFontName = "Courier";
 +
            iFontSize = 22;
 +
            sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
 +
            DrawText();
 +
        }
 +
    }
 +
}
 +
</source>
 +
|description=Set the name of the font that will be used by osDrawText.
 +
|additional_info=The specified font must exist (ie. be installed) on the server running the region containing a script that uses this function.
 +
}}

Latest revision as of 09:02, 18 November 2017

string osSetFontName(string drawList, string fontName)
Set the name of the font that will be used by osDrawText.
Threat Level This function does not do a threat level check
Permissions Use of this function is always allowed by default
Extra Delay 0 seconds
Example(s)
// ----------------------------------------------------------------
// Example / Sample Script to show function use.
//
// Script Title:    osSetFontName_osSetFontSize.lsl
// Script Author:
// Threat Level:    None
// Script Source:   SUPPLEMENTAL http://opensimulator.org/wiki/osSetFontName
//                  SUPPLEMENTAL http://opensimulator.org/wiki/osSetFontSize
//
// Notes: See Script Source reference for more detailed information
// This sample is full opensource and available to use as you see fit and desire.
// Threat Levels only apply to OSSL & AA Functions
// See http://opensimulator.org/wiki/Threat_level
// ================================================================
// C# Source Line:      public string osSetFontName(string drawList, string fontName)
// C# Source Line:      public string osSetFontSize(string drawList, int fontSize)
// Inworld Script Line: osSetFontName(string sCommandList, string sFontName);
// Inworld Script Line: osSetFontSize(string sCommandList, integer iFontSize);
//
// Example of osSetFontName & osSetFontSize
//
// Example of osDrawText - Highlighting osSetFontName & osSetFontSize
// For font families which can be used SEE:  http://www.w3schools.com/css/css_websafe_fonts.asp
//
integer iFlag = TRUE;
string sCommandList = "";   // Storage for our drawing commands
string sFontName = "Arial"; // Arial is the default font used, if unspecified
integer iFontSize = 14;     // default to 24 point for sample
integer iX = 10;            // used for osMovePen (X coord) from Top Left In
integer iY = 10;            // used for osMovePen (Y coord) from Top Left Down
string sText;
//
DrawText()
{
    sCommandList = osSetFontName(sCommandList, sFontName);
    sCommandList = osSetFontSize(sCommandList, iFontSize);
    sCommandList = osMovePen( sCommandList, iX, iY );       // Upper left corner at <pixels in, pixels down>
    sCommandList = osDrawText( sCommandList, sText);        // The Text to Display
    // Now draw the image
    llWhisper(0,"FontName = "+sFontName+" FontSize = "+(string)iFontSize);
    osSetDynamicTextureData( "", "vector", sCommandList, "width:512,height:512", 0 );
}
default
{
    state_entry()
    {
        llSay(0, "Touch to see how changing osSetFontName & osSetFontName work");
        sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
        DrawText();
    }
    touch_start(integer num)
    {
        if(iFlag)
        {
            iX = 10;
            iY = 50;
            iFlag = FALSE;
            sFontName = "Times";
            iFontSize = 18;
            sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
            DrawText();
        }
        else
        {
            iX = 10;
            iY = 100;
            iFlag = TRUE;
            sFontName = "Courier";
            iFontSize = 22;
            sText = "FontName = "+sFontName+"\nFontSize = "+(string)iFontSize;
            DrawText();
        }
    }
}
Notes
The specified font must exist (ie. be installed) on the server running the region containing a script that uses this function.


Personal tools
General
About This Wiki