jogamp › java3d

How to make a multi-line Text3D?

Classic

List

Threaded

9 messages Options

basti

How to make a multi-line Text3D?

Hello,
this is my first post here in the forum, so I want to take the time
to say Thank You to everybody involved in the continuation of Java3D.

I currently have an issue with Text3D. I can't get a multi-line String to work.

String text = "line1\nline2"; //-> turns out: line1line2
//String text = "<html>line1<br>line2</html>"; //-> turns out: <html>line1<br>line2</html>
Font font = new Font("Courier New", Font.PLAIN, 1);
Font3D font3D = new Font3D(font);
Text3D text3d = new Text3D(font3D, text);

I've tried it with \n and a html String does not work, also.

I looked into Text3DRetained but was unable to find anything explicitly
against multi-line Strings.

I'm running Java3D version 1.6.1

Maybe there's something obvious I'm missing here?

Thanks for your help,
basti

philjord

Re: How to make a multi-line Text3D?

Basti,
You are right there is no comment on how a newline is handled. The code simply treats it like another character, and use the GlyphVector to discover it is 0 wide and 0 high and has no geometry. Obviously this isn't a useful way to treat a newline.

The good news is that creating your own newlines is very straight forward.

The point size on the Text3D is in meters, and the position of it is in meters as well, so you can simply add several Text3D to the same root node and move them up or down by point size amount (plus a little space) to get a reasonable result.

It wouldn't be hard to write a MultiLineText3D class to handle this (extending javax.media.j3d.Group)

Here is the Text3D example from java3d-exmples with 2 lines of Text3D showing nicely.
Note //NEWCODE

/*
* $RCSfile$
*
* Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* - Redistribution of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any
* kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
* WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
* EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
* NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
* USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
* ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
* CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
* REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
* INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or
* intended for use in the design, construction, operation or
* maintenance of any nuclear facility.
*
* $Revision$
* $Date$
* $State$
*/

package org.jdesktop.j3d.examples.text3d;

import java.applet.Applet;
import java.awt.BorderLayout;
import java.awt.Button;
import java.awt.Font;
import java.awt.GraphicsConfiguration;
import java.awt.Panel;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.media.j3d.Alpha;
import javax.media.j3d.AmbientLight;
import javax.media.j3d.Appearance;
import javax.media.j3d.Background;
import javax.media.j3d.BoundingSphere;
import javax.media.j3d.BranchGroup;
import javax.media.j3d.Canvas3D;
import javax.media.j3d.DirectionalLight;
import javax.media.j3d.Font3D;
import javax.media.j3d.FontExtrusion;
import javax.media.j3d.Material;
import javax.media.j3d.RotationInterpolator;
import javax.media.j3d.Shape3D;
import javax.media.j3d.Text3D;
import javax.media.j3d.Transform3D;
import javax.media.j3d.TransformGroup;
import com.sun.j3d.utils.applet.MainFrame;
import com.sun.j3d.utils.behaviors.vp.OrbitBehavior;
import com.sun.j3d.utils.universe.SimpleUniverse;
import com.sun.j3d.utils.universe.ViewingPlatform;
import javax.vecmath.Color3f;
import javax.vecmath.Point3d;
import javax.vecmath.Point3f;
import javax.vecmath.Vector3f;

public class Text3DLoad extends Applet implements ActionListener {

private String fontName = "TestFont";
private String textString = null;
private double tessellation = 0.0;

private SimpleUniverse u;

private Button button;
private boolean behaviorsOn = false;
private OrbitBehavior orbit;

public BranchGroup createSceneGraph() {
float sl = textString.length();
// Create the root of the branch graph
BranchGroup objRoot = new BranchGroup();

// Create a Transformgroup to scale all objects so they
// appear in the scene.
TransformGroup objScale = new TransformGroup();
Transform3D t3d = new Transform3D();
// Assuming uniform size chars, set scale to fit string in view
t3d.setScale(1.2/sl);
objScale.setTransform(t3d);
objRoot.addChild(objScale);

// Create the transform group node and initialize it to the
// identity. Enable the TRANSFORM_WRITE capability so that
// our behavior code can modify it at runtime. Add it to the
// root of the subgraph.
TransformGroup objTrans = new TransformGroup();
objTrans.setCapability(TransformGroup.ALLOW_TRANSFORM_WRITE);
objTrans.setCapability(TransformGroup.ALLOW_TRANSFORM_READ);
objScale.addChild(objTrans);

Font3D f3d;
if (tessellation > 0.0) {
f3d = new Font3D(new Font(fontName, Font.PLAIN, 2),
tessellation,
new FontExtrusion());
}
else {
f3d = new Font3D(new Font(fontName, Font.PLAIN, 2),
new FontExtrusion());
}
Text3D txt = new Text3D(f3d, textString,
new Point3f( -sl/2.0f, -1.f, -1.f));
Shape3D sh = new Shape3D();
Appearance app = new Appearance();
Material mm = new Material();
mm.setLightingEnable(true);
app.setMaterial(mm);
sh.setGeometry(txt);
sh.setAppearance(app);
objTrans.addChild(sh);
//////////////////NEW CODE
Text3D txt2 = new Text3D(f3d, textString,
new Point3f( -sl/2.0f, 1.f, -1.f));/// only change from -1 on Y to +1 on Y, these are in meters, same as the point size
Shape3D sh2 = new Shape3D();
sh2.setGeometry(txt2);
sh2.setAppearance(app);
objTrans.addChild(sh2);
//////////////////NEW CODE

BoundingSphere bounds =
new BoundingSphere(new Point3d(0.0,0.0,0.0), 100.0);

if (false) {
Transform3D yAxis = new Transform3D();
Alpha rotationAlpha = new Alpha(-1, Alpha.INCREASING_ENABLE,
0, 0,
4000, 0, 0,
0, 0, 0);

RotationInterpolator rotator =
new RotationInterpolator(rotationAlpha, objTrans, yAxis,
0.0f, (float) Math.PI*2.0f);
rotator.setSchedulingBounds(bounds);
objTrans.addChild(rotator);
}

// Set up the background
Color3f bgColor = new Color3f(0.05f, 0.05f, 0.5f);
Background bgNode = new Background(bgColor);
bgNode.setApplicationBounds(bounds);
objRoot.addChild(bgNode);

// Set up the ambient light
Color3f ambientColor = new Color3f(0.3f, 0.3f, 0.3f);
AmbientLight ambientLightNode = new AmbientLight(ambientColor);
ambientLightNode.setInfluencingBounds(bounds);
objRoot.addChild(ambientLightNode);

// Set up the directional lights
Color3f light1Color = new Color3f(1.0f, 1.0f, 0.9f);
Vector3f light1Direction = new Vector3f(1.0f, 1.0f, 1.0f);
Color3f light2Color = new Color3f(1.0f, 1.0f, 0.9f);
Vector3f light2Direction = new Vector3f(-1.0f, -1.0f, -1.0f);

DirectionalLight light1
= new DirectionalLight(light1Color, light1Direction);
light1.setInfluencingBounds(bounds);
objRoot.addChild(light1);

DirectionalLight light2
= new DirectionalLight(light2Color, light2Direction);
light2.setInfluencingBounds(bounds);
objRoot.addChild(light2);

return objRoot;
}

private void usage()
{
System.out.println(
"Usage: java Text3DLoad [-f fontname] [-t tessellation] [<text>]");
System.exit(0);
} // End of usage

public Text3DLoad() {}

public Text3DLoad(String args[]) {

if (args.length == 0) {
// usage();
textString = "Java3D";
}
else {
for (int i = 0 ; i < args.length ; i++) {
if (args[i].startsWith("-")) {
if (args[i].equals("-f")) {
if (i < args.length - 1) {
fontName = args[++i];
}
else {
usage();
}
}
else if (args[i].equals("-t")) {
if (i < args.length - 1) {
tessellation = Double.parseDouble(args[++i]);
}
else {
usage();
}
}
else {
System.err.println("Argument '" + args[i] +
"' ignored.");
}
}
else {
textString = args[i];
}
}
}

if (textString == null) {
usage();
}

}

public void init() {System.setProperty("sun.awt.noerasebackground", "true");

if (textString == null) {
textString = "Java3D";
}
setLayout(new BorderLayout());

button = new Button("remove behaviors");
button.addActionListener(this);
Panel p = new Panel();
p.add(button);
add("South", p);

GraphicsConfiguration config =
SimpleUniverse.getPreferredConfiguration();

Canvas3D c = new Canvas3D(config);
add("Center", c);

// Create a simple scene and attach it to the virtual universe
BranchGroup scene = createSceneGraph();

// create a SimpleUniverse with 4 TransformGroups for the mouse
// behaviors
u = new SimpleUniverse(c);

// add the behaviors to the ViewingPlatform
ViewingPlatform viewingPlatform = u.getViewingPlatform();

viewingPlatform.setNominalViewingTransform();

// add orbit behavior to ViewingPlatform
orbit = new OrbitBehavior(c, OrbitBehavior.REVERSE_ALL |
OrbitBehavior.STOP_ZOOM);
BoundingSphere bounds =
new BoundingSphere(new Point3d(0.0, 0.0, 0.0), 100.0);
orbit.setSchedulingBounds(bounds);
viewingPlatform.setViewPlatformBehavior(orbit);

behaviorsOn = true;

u.addBranchGraph(scene);
}

public void destroy() {
u.cleanup();
}

public void actionPerformed(ActionEvent e) {
if (e.getSource() == button) {
ViewingPlatform v = u.getViewingPlatform();
if (behaviorsOn) {
v.setViewPlatformBehavior(null);
button.setLabel("add behaviors");
behaviorsOn = false;
}
else {
v.setViewPlatformBehavior(orbit);
button.setLabel("remove behaviors");
behaviorsOn = true;
}
}
}

//
// The following allows Text3DLoad to be run as an application
// as well as an applet
//
public static void main(String[] args) {System.setProperty("sun.awt.noerasebackground", "true");
new MainFrame(new Text3DLoad(args), 700, 700);
}
}

basti

Re: How to make a multi-line Text3D?

philjord,
Thank you for your help. After a little bit of trial and error, I managed to get a decent (I hope) result.

MultiLineText3D.java
MultiLineText3DTest.java

basti

philjord

Re: How to make a multi-line Text3D?

Basti,
That looks great, I like the ability to change on the fly.
I've never used a Function or BiFunction so that was educational (I'm a bit old school, can't stand this new-fangled lambda nonsense).
The use of handing in a BiFunction sorts out the problem of needing a J3DGraphics2D, but also makes it a bit less encapsulated,
I assume you had to so that because my trivial stringLength is nothing like appropriate for the actual character widths.

One thing that intrigues me is why you went with a TransformGroup rather than just manipulating the position Vector3f for each line?

Phil.

Sven Gothel

Re: How to make a multi-line Text3D?

Administrator

In reply to this post by basti

great resolution & team work.

FYI .. this is how I coded text processing for Graph,
i.e. '\n', whitespace and kerning:

https://jogamp.org/cgit/jogl.git/tree/src/jogl/classes/jogamp/graph/font/typecast/TypecastFont.java?id=a251f5734cc1f5c907f239c3ca3a4f1d4c262058#n390

basti

Re: How to make a multi-line Text3D?

This post was updated on .

In reply to this post by philjord

philjord,
thanks. Glad you like it.

You're right i wanted to make the class independent of J3DGraphics2D or even Canvas3D, which it shouldn't know anything about.
I actually tried using just the String length approach until i realized that i tested it only with "Courier New"
(for which all the characters have the same width). For some reason i was unable to find a good solution for getting the width of a String without a Graphics instance.
The downside of course is, that now the class is dependent on java-1.8 or higher ;)

About the TransformGroup: I think i had an issue with aligning the lines properly after updating a line and for some reason it worked with the TransformGroup.
Initially i tried to set the alignment for each line individually but abandoned that idea. But you're right it should work without the TransformGroup.
If i find the time i work on it some more tonight.

@Sven Gothel
Thank you, i haven't looked into this
I see: left_glyph is set to null on white space characters

Looking at TypecastFont alone, i must say i can't begin to imagine all the work you guys put into this project...

*UPDATE*
@philjord
I implemented a version without the use of TransformGroup and called setPosition(Point3f p) on Text3D directly.
There's a small misalignment after updating the line, which i can't explain. I put it all in a zip file for comparison.
MultiLineText3D_test_without_TransformGroup.zip

best regards,
basti

gouessej

Re: How to make a multi-line Text3D?

Administrator

In reply to this post by basti

Hello

I advise you to use a more recent version of Java3D even though it has nothing to do with your current problem, you might miss some fixes by using an obsolete version, Java3D 1.6.2 and Java3D 1.7.1-build-20200222 (using a different namespace) are available.

Julien Gouesse | Personal blog | Website

basti

Re: How to make a multi-line Text3D?

Hello gouessej,

you are absolutely right, i am actually in the middle of migrating to Java3D 1.7 right now.
But since you've mentioned v1.6.2 ... i discovered that i indeed downloaded this version from here:
https://jogamp.org/deployment/java3d/1.6.2/jogamp-java3d.7z and am currently running it.

But when i fetch the version String via:

String version = (String) VirtualUniverse.getProperties().get("j3d.version");
System.out.println(version);

I get this result: 1.6.1 fcs fcs

I wonder if this is just me ?

basti

gouessej

Re: How to make a multi-line Text3D?

Administrator

Good catch, maybe Phil should try to reproduce your bug.

Julien Gouesse | Personal blog | Website