CGI-Parameter:

URL

src

dev

dpi

ochem

error

result

urlencoding

latin1|utf8

Dieser optionale Parameter hat den Standardwert utf8. Achtung, dieser Wert wird nur im Falles
eines GET-Requests ausgwertet:
utf8:
  http://sciencesoft.at/image/latexurl/img.png?template=textutf8&src=Test:%20%C3%B6
latin1:
  http://sciencesoft.at/image/latexurl/img.png?template=textutf8&urlencoding=latin1&src=Test:%20%F6

template

    \documentclass[12pt]{article}
    \pagestyle{empty}
    \begin{document}\\begin{math}
    ...
    \end{math}\\end{document}
    

    \documentclass[12pt]{article}
    \pagestyle{empty}
    \begin{document}
    ...
    \end{document}
    

    \documentclass[12pt]{article}
    \pagestyle{empty}
    \usepackage[utf8]{inputenc}
    \usepackage[T1]{fontenc}
    \begin{document}
    ...
    \end{document}
    

    \documentclass[12pt]{article}
    \pagestyle{empty}
    \begin{document}
    \begin{displaymath}
    ...
    \end{displaymath}
    \end{document}
    

    \documentclass[12pt]{article}
    \usepackage{amssymb,amsmath}
    \pagestyle{empty}
    \begin{document}
    \begin{displaymath}
    ...
    \end{displaymath}
    \end{document}
    

    \documentclass{article}
    \pagestyle{empty}
    \usepackage{ochem}
    \begin{document}
    \begin{chemspecial}
    include(`utils.inc')
    include(`natur.inc')
    require("bicyclib")
    \end{chemspecial}
    \begin{chemistry}
    ...
    \end{chemistry}
    \end{document}
    

Beispiel

Dieses Beispiel generiert über die CGI-Schnittstelle eine PDF-Datei im Papierformat A4 mit
der Schrödingergleichung als Inhalt. Sie können dieses Beispiel inklusive aller notwendigen Libraries über
folgenden Link herunterladen.

/*
 * LaTeXClient.java - LaTeX CGI access example
 * Author: Peter Sauer (peter.sauer@sciencesoft.at)
 * Date of last modification: 2008-09-25
 * HTTPClient: http://hc.apache.org/httpclient-3.x/userguide.html
 */

package at.sciencesoft.test;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.*;
import java.io.*;

public class LaTeXClient {
    private static String url = "http://sciencesoft.at/image/latexurl";
    private static String schroedinger =
            "\\documentclass[12pt]{article}\n" +
            "\\pagestyle{empty}\n" +
            "\\begin{document}\n"+
            "\\begin{displaymath}\n" +
            "\\bf\n" +
            "\\int H(x,x')\\psi(x')dx' = -\\frac{\\hbar^2}{2m}\\frac{d^2}{dx^2}\n" +
            "\\psi(x)+V(x)\\psi(x)\n" +
            "\\end{displaymath}\n" +
            "\\end{document}\n";

    public static void main(String[] args) throws Exception {
        // Prepare HTTP post
        PostMethod post = new PostMethod(url);
        // Request content will be retrieved directly from the input stream
        NameValuePair[] postdata = {
            new NameValuePair("src", schroedinger),
            new NameValuePair("dev", "pdfwrite"),
            new NameValuePair("papersize", "a4"),
            new NameValuePair("template", "no")
        };
        // Set charset to UTF-8
        post.setRequestHeader("Content-Type",
            PostMethod.FORM_URL_ENCODED_CONTENT_TYPE + ";charset=utf-8");
        post.setRequestBody(postdata);
        // Get HTTP client
        HttpClient httpclient = new HttpClient();
        // Execute request
        try {
            int result = httpclient.executeMethod(post);
            // Display status code
            System.out.println("Response status code: " + result);
            if (result == 200) {
                FileOutputStream test = new FileOutputStream("test.pdf");
                test.write(post.getResponseBody());
                test.close();
                System.out.println("Success!");
            }
        } finally {
            // Release current connection to the connection pool once you are done
            post.releaseConnection();
        }
    }
}

XML Request

<?xml version="1.0" encoding="UTF-8"?>  
<latex ochem="false">
  <dev dpi="120">png16m</dev>
  <src><![CDATA[\documentclass[12pt]{article}
    \pagestyle{empty}
    \begin{document}
    Hallo World!
    \end{document}]]>
  </src>
  <embeddedData>false</embeddedData>
</latex>

URL

latex

dev

src

embeddedData

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<RESTlatexResult>
  <success>?</success>
  <error>?</error>
  <embeddedData>?</embeddedData>
  <url>?</url>
  <data>?</data>
  <fileExt>?</fileExt>
  <size>?</size>
  <width>?</width>
  <height>?</height>
</RESTlatexResult>

succces

error

embeddedData

url oder data

size

fileExt

width & height

Beispiel

Dieses Beispiel erzeugt über die REST-Schnittstelle eine Grafik und speichert diese.
Sie können dieses Beispiel inklusive aller notwenigen Libraries über folgenden Link herunterladen.

package at.sciencesoft.test;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.*;
import sun.misc.BASE64Decoder;
import java.io.*;

/*
 * LaTeXRESTClient.java
 * LaTeX REST access example
 * Author: Peter Sauer (peter.sauer@sciencesoft.at)
 * Date of last modification: 2009-06-13
 * HTTPClient: http://hc.apache.org/httpclient-3.x/userguide.html
 */


public class LaTeXRESTClient {

    private static String url = "http://sciencesoft.at/latex";

    public static void writeByteStream(String fileName, byte[] stream) throws Exception {
        File file = new File(fileName);
        FileOutputStream writer = new FileOutputStream(file);
        writer.write(stream, 0, stream.length);
        writer.close();
    }

    public static char[] readCharStream(String fileName) throws Exception {
        File file = new File(fileName);
        FileReader reader = new FileReader(file);
        int fileLength = (int) file.length();
        char[] stream = new char[fileLength];
        reader.read(stream, 0, fileLength);
        reader.close();
        return stream;
    }

    public static void main(String[] args) throws Exception {
        String xml = new String(readCharStream(args[0]));
        // Prepare HTTP put
        PutMethod put = new PutMethod(url);
        // Request content will be retrieved directly
        // from the input stream
        put.setRequestHeader("Content-Type", "text/xml; charset=utf-8");
        put.setRequestEntity(new StringRequestEntity(xml, null, "utf-8"));
        // Get HTTP client
        HttpClient httpclient = new HttpClient();
        // Execute request
        try {
            int result = httpclient.executeMethod(put);
            // Display status code
            System.out.println("Response status code: " + result);
            if (result == 200) {
                // fetching quick & dirty the binary data
                xml = put.getResponseBodyAsString();
                if (xml.indexOf("<success>true</success>") >= 0) {
                    int start = xml.indexOf("<data>");
                    int end = xml.indexOf("</data>");
                    if (start >= 0 && end >= 0) {
                        start += "<data>".length();
                        writeByteStream(args[1],
                          new BASE64Decoder().decodeBuffer(xml.substring(start, end)));
                    } else {
                        System.out.println(xml);
                    }
                } else {
                    System.out.println(xml);
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // Release current connection to the connection pool once you are done
            put.releaseConnection();
        }
    }
}

WDSL

SOAP-Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://DefaultNamespace">
   <soapenv:Header/>
   <soapenv:Body>
      <def:compile>
         <def:source>?</def:source>
         <def:device>?</def:device>
         <def:deviceInfo>?</def:deviceInfo>
         <def:dpi>?</def:dpi>
         <def:utf8>?</def:utf8>
         <def:ochem>?</def:ochem>
         <def:embeddedData>?/def:embeddedData>
      </def:compile>
   </soapenv:Body>
</soapenv:Envelope>
  

<def:source>

<def:device>

<def:deviceInfo>

<def:dpi>

<def:utf8>

<def:ochem>

<def:embeddedData>

SOAP-Response

  <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Body>
      <ns1:compileResponse xmlns:ns1="http://DefaultNamespace">
         <ns1:out>
            <success xmlns="http://DefaultNamespace">?</success>
            <error xsi:nil="true" xmlns="http://DefaultNamespace">?</error>
            <embeddedData xmlns="http://DefaultNamespace">false</embeddedData>
            <width xmlns="http://DefaultNamespace">?</width>
            <height xmlns="http://DefaultNamespace">?</height>
            <size xmlns="http://DefaultNamespace">?</size>
            <fileExt xmlns="http://DefaultNamespace">?</fileExt>
            <data xsi:nil="true" xmlns="http://DefaultNamespace">?</data>
            <url xmlns="http://DefaultNamespace">?</url>
         </ns1:out>
      </ns1:compileResponse>
   </soap:Body>
</soap:Envelope>

succces

error

embeddedData

url oder data

size

fileExt

width & height

Beispiel

Dieses Beispiel erzeugt über die SOAP-Schnittstelle eine PDF-Datei und speichert diese.
Sie können dieses Beispiel inklusive aller notwenigen Libraries über folgenden Link herunterladen.

/*
 * LaTeXSOPAClient.java - LaTeX SOAP access example
 * Author: Peter Sauer (peter.sauer@sciencesoft.at)
 * Date of last modification: 2008-11-07
 */
package at.sciencesoft.test;

import at.sciencesoft.soap.latex.*;
import java.io.*;

public class LaTeXSOAPClient {
    private static String schroedinger =
            "\\documentclass[12pt]{article}\n" +
            "\\pagestyle{empty}\n" +
            "\\begin{document}\n" +
            "\\begin{displaymath}\n" +
            "\\bf\n" +
            "\\int H(x,x')\\psi(x')dx' = -\\frac{\\hbar^2}{2m}\\frac{d^2}{dx^2}\n" +
            "\\psi(x)+V(x)\\psi(x)\n" +
            "\\end{displaymath}\n" +
            "\\end{document}\n";

    public static void writeByteStream(String fileName, byte[] stream) throws Exception {
        File file = new File(fileName);
        FileOutputStream writer = new FileOutputStream(file);
        writer.write(stream, 0, stream.length);
        writer.close();
    }

    public static void main(String[] args) {
        try {
            Latex_Service serv = new Latex_Service();
            Latex latex = serv.getLatexHttpPort();
            SOAPlatexResult lr = latex.compile(schroedinger, "pdfwrite", "a4", 120, true,false, true);
            if (lr.isSuccess()) {
                System.out.println("Success!");
                writeByteStream("test.pdf", lr.getData().getValue());
            } else {
                System.out.println("Error:");
                System.out.println(lr.getError().getValue());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

• Die Schaltfläche LaTeX starten wandelt den Quelltext im Eingabefeld in eine Grafik um.
• Das Eingabefeld DPI (Dots Per Inch) gibt an, mit welcher Auflösung die Grafik berechnet wird (gültiger Bereich: 60-600 DPI).
• Das Kontrollkästchen UTF-8 legt fest, ob der Quelltext als UTF-8 oder Latin-1 gepeichert wird.
• Die Schaltfläche Löschen löscht das komplette Eingabefeld.
• Über die Auswahlliste Vorlagen & Beispiele und die Schaltfläche laden können Vorlagen oder Beispiele in das Eingabefeld kopiert werden.
• Mit Hilfe der Auswahlliste Format kann das Ausgabeformat festgelegt werden. Zusätzlich zu den diversen Grafikformaten kann mit pdfwrite eine PDF-Datei erzeugt werden.