141 lines
5.0 KiB
Java
141 lines
5.0 KiB
Java
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* ***** BEGIN LICENSE BLOCK *****
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is mozilla.org code.
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* Netscape Communications Corporation.
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
* either the GNU General Public License Version 2 or later (the "GPL"), or
|
|
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
* the provisions above, a recipient may use your version of this file under
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
*
|
|
* ***** END LICENSE BLOCK ***** */
|
|
/*
|
|
nffp.java (FontDisplayer.java)
|
|
|
|
Interface definition of FontDisplayer
|
|
dp <dp@netscape.com>
|
|
*/
|
|
|
|
|
|
// ----------------------------------------------------------------------
|
|
// The Object that serves Fonts.
|
|
// The FontDisplayer will only be used by the FontBroker. There would exist
|
|
// multiple FontDisplayers that server different types of fonts.
|
|
//
|
|
// Notes:
|
|
// - The FontDisplayer need not do reference counting of Font objects.
|
|
// The FontBroker does this for the FontDisplayer.
|
|
// ----------------------------------------------------------------------
|
|
|
|
package netscape.fonts;
|
|
|
|
import netscape.jmc.*;
|
|
|
|
public interface nffp {
|
|
//
|
|
// The Following methods reflect their equivalents in FontBroker
|
|
//
|
|
public Object LookupFont(nfrc rc, nffmi matchInfo, ConstCString accessor);
|
|
|
|
|
|
// Creates a fonthandle from a fontfile. This is a synchronous call.
|
|
public Object CreateFontFromFile(nfrc rc, ConstCString mimetype,
|
|
ConstCString fontFile, ConstCString urlOfPage);
|
|
|
|
//
|
|
// The stream created is passed the font data as it is downloaded.
|
|
//
|
|
public nfstrm CreateFontStreamHandler(nfrc rc, ConstCString urlOfPage);
|
|
|
|
//
|
|
// NOTE: This allocates memory for the return list. Caller needs to
|
|
// free this memory using nffbu::free()
|
|
//
|
|
public double[] EnumerateSizes(nfrc rc, Object fh);
|
|
|
|
// A release mechanism for the object returned by LookupFont and DefineFont
|
|
public int ReleaseFontHandle(Object fh);
|
|
|
|
// The fmi that corrsponding to the font handle
|
|
public nffmi GetMatchInfo(Object fh);
|
|
|
|
//
|
|
// RenderableFont is the result of applying transformations
|
|
// on this BaseFontHandle. If BaseFontHandle is NULL, then
|
|
// fontname is used instead. Currently supported transformations
|
|
// are sizing
|
|
//
|
|
public nfrf GetRenderableFont(nfrc rc, Object fh, double pointsize);
|
|
|
|
//
|
|
// Catalogue Routines
|
|
|
|
//
|
|
// NOTE: This DOES NOT allocate memory for the return strings. Caller
|
|
// SHOULD NOT free it and should take a private copy for storing
|
|
// or modification of the returned strings.
|
|
//
|
|
public String Name();
|
|
public String Description();
|
|
|
|
//
|
|
// The returned string is of the format
|
|
// mime/type:suffix[,suffix]...:Description
|
|
// [;mime/type:suffix[,suffix]...:Description]...
|
|
//
|
|
// NOTE: This DOES NOT allocate memory for the return strings. Caller
|
|
// SHOULD NOT free it and should take a private copy for storing
|
|
// or modification of the returned strings.
|
|
//
|
|
public String EnumerateMimeTypes();
|
|
|
|
|
|
//
|
|
// Returns a list of fonts that match the input FontMatchInfo.
|
|
// The list is an array of objects that implement the FontMatchInfo
|
|
// interfaces. These correspond to the FontDisplayerCatalogue interface.
|
|
//
|
|
// NOTE: This allocates memory for the list of returned FMI array.
|
|
// Caller needs to free the list by calling nffbu::free()
|
|
// apart from releasing each of the fmi objects.
|
|
//
|
|
public nffmi[] ListFonts(nfrc rc, nffmi fmi);
|
|
//
|
|
// NOTE: This allocates memory for the return list. Caller needs to
|
|
// free this memory using nffbu::free()
|
|
//
|
|
public int[] ListSizes(nfrc rc, nffmi fmi);
|
|
|
|
// If this returns a non-zero value, then the FontBroker will cache the
|
|
// output of any Enumerate*() request and use that during the next
|
|
// invocation instead of loading this dll/dso every time at startup
|
|
// for getting this information.
|
|
public int CacheFontInfo();
|
|
}
|