4.6 | 11 ratings Rate this file 54 Downloads (last 30 days) File Size: 436 KB File ID: #32207 Version: 1.9
image thumbnail

Matlab 3D figure to 3D (X)HTML


Dirk-Jan Kroon (view profile)


13 Jul 2011 (Updated )

Converts 3D objects of a Matlab figure to XHTML embedded X3D file. Interactive 3D website graphics.

Editor's Notes:

This file was selected as MATLAB Central Pick of the Week

| Watch this File

File Information

This function FIGURE2XHTML converts the 3D objects of a Matlab figure to an in XHTML embedded X3D file. In a modern browser, you can then view your figure interactively because of the great X3DOM Library (Instant 3D the HTML way! http://www.x3dom.org/).
Currently the function supports: Axes, Patch, Line, Surface, Text, Images and Light Objects.

Note: Even volume rendering in your browser is possible, by using: http://www.mathworks.com/matlabcentral/fileexchange/19155-volume-render

Browsers supported:
 - Google Chrome 9.x and above
 - Firefox 4.x and above
 - Webkit nightly builds
 - Flash11 needed for Internet explorer (or InstantReality-plugin)

  Note : All input arguments are optional, and sorting doesn't matter
 thus figure2xhtml(); is valid but also figure2xhtml(options,handle);

    filename : Name of the XHTML file (also an X3D file is created).
           When empty or not known a File-Dialog is shown
    handle : Figure handle or axis handle
           When empty or not known the current axis (GCA) is used
    options : A struct with options
      options.output : Produce output files 'x3d', 'xhtml' or 'both' (default)
      options.width : Width of X3D render object in pixels default 500
      options.height : Height of X3D render object in pixels default 500
      options.headlight : Enable Camera head light, boolean true/false
                    (default true)
      options.title : Title of xhtml page, default 'Matlab X3D'
      options.interactive : Make mesh/surface objects clickable in xhtml,
                    boolean true/false (default false)
   figure, hold on; axis equal;
   patch(FV,'facecolor',[1 0 0],'facealpha',0.5);


This file inspired Export Figure To 3 D Interactive Pdf.

MATLAB release MATLAB 7.12 (R2011a)
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (26)
29 Jul 2014 carlosgeldo

My problem is solved, to set options you must create

options = struct('output','both','height',500,...); %names in help or in figure2xhtml.m
figure2xhtml(options,h) % "save as" window is opened

Comment only
29 Jul 2014 carlosgeldo

Incredible work!! But could you help me, please? I write:

figure2xhtml(h); %I want the dialog

I would like set options.title and options.interactive, but I don't know how I can do it. Could you give an example?

07 Jul 2014 Curtis

Curtis (view profile)

Works great, but can only be used for surfaces defined by 3 matrices surf(X,Y,Z) or one matrix surf(Z), but not 2 vectors and a matrix surf(x,y,Z)

Error using horzcat
Dimensions of matrices being concatenated are not consistent.

Error in surf2FV (line 13)
V=[XData(:) YData(:) ZData(:)];

29 Jan 2014 Dimid Duchovny  
28 Aug 2013 Emmanuel Farhi

A remarkable work, and it just works !
However, as the exported files are ASCII based, beware of the size of the object to export.

25 Mar 2013 Ben Jordan

Thank you for this. Can you make any suggestions about how to extend your code to allow for an animated series to be played?

Comment only
10 May 2012 Laila

Laila (view profile)


mini question: is there anyway to get it to work with elements from an hggroup (such as quiver3?).

18 Mar 2012 Truong

Truong (view profile)

I ran on a 3-D figure (created with patches) and got the following error:
??? SWITCH expression must be a scalar or string constant.

Error in ==> addmesh at 142

Error in ==> figure2xhtml>figurex3d at 196

Error in ==> figure2xhtml at 164

The examples provided with the function ran well without errors.

Comment only
21 Feb 2012 Alex

Alex (view profile)

Does this plugin support color images as texture or just grayscale images?

Comment only
19 Dec 2011 Dr. Siva Srinivas Kolukula

Very good work....I have been searching for saving a MATLAB figure interactively into html. Searched and found the MATLAB builder ja which is bit complicated. My further search landed me here. Very good work.
But I have a problem in this. I ran these files and saved html version in test folder. I tried to open it with chrome and mozilla which are leatest, I get a blank screen showing X3DOM downloading the secene, but never I am getting the interactive image. Flash player is installed.
Why is it? Any solution?


Comment only
11 Nov 2011 J. Hu

J. Hu (view profile)

Thanks for the awesome work. I have been looking for this kind of program for a long time. I really want to explore it. However, I cannot get it to work on my computer. Running the matlab code has no problem. When I tried to open the xhtml file using the latest IE with adobe 11 installed, the web page just show X3DOM Loading Scene... and it neven show up.

I tried to open the xhtml file using the lastest Chrome also. The progrom says that Matalb X3D not responsive and nothing show up also.

Does anybody has the same problem I had and happen to know what may be the reasons, how to fix it?


29 Sep 2011 Alexander Brodsky

very exciting option.
It can be interesting include of your option as apart of publish MATLAB function.
Or may be you know how to do that ?

25 Aug 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

The same viewpoint is not supported.

The camera in Matlab is a little bit strange, (almost) orthogonal, allows non-uniform x,y scaling and does some tricks to stay outside the rendered object. Thus porting the viewpoint to X3D gave strange results.

Comment only
24 Aug 2011 Ben

Ben (view profile)

Could I use the same viewpoint as that for the figure?

Comment only
20 Aug 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

Do you get an error with your MRI data?, or know what is the problem?

Comment only
19 Aug 2011 Nino

Nino (view profile)

I test it with the MRI brain of Matlab and is not working, but cheek it with your example and is pretty cool. Thanx for sharing

Comment only
16 Aug 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

The latest version supports options like a title.

Comment only
15 Aug 2011 Ben

Ben (view profile)

Is there a way to specify the title, the header, and the object name? That would be very helpful. Otherwise, one has to modify the xhtml source code every time, which could be tedious...

Give you 4 stars because the tool is cool!

12 Aug 2011 xu

xu (view profile)

Comments are almost completely absent from the code.

Comment only
22 Jul 2011 Petter

Petter (view profile)

Comments are almost completely absent from the code.

22 Jul 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

*Sven Körner
Nice tools, Javaview is indeed a very extensive 3D viewer for the web.

I don't know the u3d-file format, but maybe it is possible to include line geometry thus allow axis2lines function.

There are way to many geometry-file formats, hopefully they will merge sometime.

Comment only
21 Jul 2011 Sven Koerner

Sven Koerner (view profile)

Thank's for update - it works well! For my 3D-HTML version I used javaview - there is the axis option already embedded.(http://wwwpub.zih.tu-dresden.de/~s9034647/peaksurface.html)
But in the tool to embded u3d files in pdf - there is actually also no axis-feature (http://www.mathworks.com/matlabcentral/fileexchange/27245-generate-vertices-faces-and-color-for-u3d-format). Maybe I can use your axis2lines function?

Comment only
20 Jul 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

*Sven Körner
I added an example with axis to xhtml in the last update (is probably online tomorrow).

Comment only
20 Jul 2011 Oliver Woodford

Absolutely brilliant.

20 Jul 2011 Dirk-Jan Kroon

Dirk-Jan Kroon (view profile)

*Sven Körner
Axis are not supported by the x3dom library, but text and lines are.
Thus a solution can be to draw the axis your self using plot3 in Matlab

Comment only
20 Jul 2011 Sven Koerner

Sven Koerner (view profile)

This is pretty cool.
Is there a way how to get the coordinate system (x,y and z-axis) of a function in the 3D-graph?

15 Jul 2011 1.1

- Added Surface Texture Support
- Fixed NaN bug in vertex-normals

20 Jul 2011 1.2

added text support, and example with axis in xhtml.

21 Jul 2011 1.4

Font-size adjustment

02 Aug 2011 1.5

Added Line-Marker support

03 Aug 2011 1.6

Added images support.
Added reverse axis support.

03 Aug 2011 1.7

added alphamap support

16 Aug 2011 1.8

Added options

17 Aug 2011 1.9

Improved Internet Explorer support

Contact us