CaveView.js icon indicating copy to clipboard operation
CaveView.js copied to clipboard

Documentation

Open ariaveta opened this issue 7 years ago • 25 comments

Hello, I'd like to understand how to enable by default some features like showing terrain and map overlay shading.

Any hint? Any example? Thanks

ariaveta avatar Dec 20 '17 23:12 ariaveta

Hi,

I need to document terrain creation, do you have a survey/area in mind?

If you could provide an example survey - preferably a survex .3d model with the coordinate reference system defined using the '*CS OUT" command, I can document the process for you.

Adding overlays is relatively simple when terrain data is available.

aardgoose avatar Dec 21 '17 20:12 aardgoose

Hello, I meant not creation of 3d models. I simply need to show terrain by default in Caveview. I already have some 3d models, you can see them here:

http://www.speleotoscana.it/programmi_php_mm/caveview.html

You can enable terrain and shadowing and also a map.

But I need terrain and shadowing enabled as the user opens the page, without being forced to use settings menu. I guess it's only a matter to set some javascript variables, but I found no examples about that.

Thanks

ariaveta avatar Dec 21 '17 20:12 ariaveta

Hi,

OK, I see what you want, It is not possible in a reliable way at the moment, however should be very simple to add, it was something I had planned to do.

I'll sort this out.

aardgoose avatar Dec 22 '17 11:12 aardgoose

Hi,

You can now set initial view settings with the latest version. The 1.4.0 release notes give an example of this. Examples of the properties of the view object can be seen in the script that drives the display on the project home page:

https://github.com/aardgoose/CaveView.js/blob/gh-pages/CaveView/lib/demoscript.js

aardgoose avatar Dec 23 '17 23:12 aardgoose

Hello. great job, thanks!

ariaveta avatar Dec 23 '17 23:12 ariaveta

Hi,

The latest version (1.5.0) now has much better wall rendering for .lox models

aardgoose avatar Jan 06 '18 22:01 aardgoose

Thanks, we used 1.5 on our website (unfortunately it's in Italian):

http://www.speleotoscana.it/3d/

You can explore 3D models of some caves in Tuscany.

Just a little note: if you set HUD: true in initial settings HUD don't get displayed, but the radio button is selected. If you cycle the radio button, you get HUD.

ariaveta avatar Jan 16 '18 18:01 ariaveta

Hi,

Nice looking models....

I'll take a look at the HUD issue - the initial display setting needs some revision. The next version will use much less memory.

If you are interested I will look at making it possible to add alternative languages for the menus.

aardgoose avatar Jan 19 '18 17:01 aardgoose

Hello, thanks for your email.

Yes, I'm interested and, of course, I can translate it in Italian.

Ciao.

2018-01-19 18:19 GMT+01:00 aardgoose [email protected]:

Hi,

Nice looking models....

I'll take a look at the HUD issue - the initial display setting needs some revision. The next version will use much less memory.

If you are interested I will look at making it possible to add alternative languages for the menus.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/aardgoose/CaveView.js/issues/10#issuecomment-359032404, or mute the thread https://github.com/notifications/unsubscribe-auth/ACLZD7fTBjF9_yMO0b0_PkFR7Uz8CAqQks5tMM6ggaJpZM4RJFSK .

ariaveta avatar Jan 19 '18 23:01 ariaveta

Hello, could you please provide a bit of documentation about new features usage?

Thanks.

I noticed map overlay in our models is not enabled by default in 1.6 but it was in 1.5. Here's the initial settings we use:

view: {   section: 0,   entrances: false,   cameraType: CV.CAMERA_ORTHOGRAPHIC,   box: false,   terrain: true,   view: CV.VIEW_ELEVATION_E,   shadingMode: CV.MAP_OVERLAY,   terrainShading: CV.SHADING_OVERLAY,   walls: true,   HUD: false,   autoRotate: false,   autoRotateRate: 1.0,   stations: false,   stationLabels: false,   fullscreen: false   }

ariaveta avatar Jan 26 '18 08:01 ariaveta

Hi, the overlay not showing is a bug I've introduced. Fix coming soon Documentation of language etc to come (a bit busy at the moment)

aardgoose avatar Jan 27 '18 17:01 aardgoose

In case you haven't noticed I have added some quick info on the language translation mechanism.

aardgoose avatar Mar 08 '18 11:03 aardgoose

I admit not to have seen those info.

Where can I find them?

Thanks

2018-03-08 12:08 GMT+01:00 aardgoose [email protected]:

In case you haven't noticed I have added some quick info on the language translation mechanism.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/aardgoose/CaveView.js/issues/10#issuecomment-371456496, or mute the thread https://github.com/notifications/unsubscribe-auth/ACLZD0dyg4idTXdzonPvjfqW7LxMOa_vks5tcREegaJpZM4RJFSK .

ariaveta avatar Mar 08 '18 16:03 ariaveta

(linked from the demo page)

https://aardgoose.github.io/CaveView.js/translation.html

aardgoose avatar Mar 08 '18 17:03 aardgoose

Hi, this really looks awesome.

Is it possible to make detailed tutorial?

I have terrain images (geotiff) available. If I understand correctly it is also possible to use some tile provider like OSM?

The issue I have it, that terrain image is in different CRS. So I am a bit lost how to solve this.

I can provide terrain image and .3d file if that would help.

Othervise, this plugin really rocks :)

MaticDiba avatar Oct 29 '18 09:10 MaticDiba

Hi,

Thanks, I know the documentation needs improving. If you can provide a terrain file and .3d file that would be great. I can use that as a test case to document the process of creating height tiles. I can handle CRS conversion and will document that.

For the terrain image overlays I have used Bing/OSM and some WMTS providers, again this needs documenting properly.

aardgoose avatar Oct 29 '18 20:10 aardgoose

Hi, thanks for fast respond. I've uploaded a zip to wetransfer. There is survex project included with img file that represents terrain image. I'm not sure if that is what is needed for terrain generation in CaveView. Other then that I can provide .asc files for that area (one example is in ExampleOfAsci folder).

If there is anything else that I can help with, just let me know. Also regarding helping making tutorial/example. I'm just stuck at this point of how to use terrain image that I have right now.

CRS that I use are in .svx file.

Thanks for your help.

MaticDiba avatar Oct 30 '18 07:10 MaticDiba

Hi, Thanks, does the DTM use the same CRS as the Survex data? It looks like it does.

aardgoose avatar Oct 31 '18 14:10 aardgoose

Yes it does. I didn't manage to get this info with dtm (I'm still learning the awesome stuff in GIS world :)).

I got .asc file from our national agency, and created .tiff with SAGA GIS, so I was able to use it in qGis.

MaticDiba avatar Oct 31 '18 19:10 MaticDiba

I've made a small set of tiles to cover your example cave.

You can drag and drop onto the demo site at https://aardgoose.github.io/CaveView.js/fulldemo.html

It looks right to me, the tiff doesn't quite cover the region but looks like a match to the images on katasterjam.si.

Just got to write up the procedure now.

I use a third GIS product to create the tiles, GRASS GIS which you probably have because it comes bundled with QGIS.

aardgoose avatar Nov 03 '18 18:11 aardgoose

Hi, sorry I don't quite underatan where tiles are :)

By the way ... I used CaveView on katasterjam, so users can just upload 3d to a cave or multiple caves, and then dynamically display it with CaveView: https://www.katasterjam.si/Caves/Details/10904#dokumenti

I was thinking of creating tiles for uploaded 3d with a service in a cloud. But I will see if that could be automated.

MaticDiba avatar Nov 03 '18 19:11 MaticDiba

Hi, I tested my model on your demo website. It seems like it works.

I guess now, I will just have to figure it out how to use las or asc files and convert them into tiles with grass library.

I must say, CaveView really is an awesome library! Thumbs up!!!

MaticDiba avatar Nov 19 '18 13:11 MaticDiba

Hi,

I have put up some documentation for tile creation here.

Hope this is useful and let me known about any errors in the docs.

Cheers

aardgoose avatar Nov 20 '18 10:11 aardgoose

I read the documentation and it's clear what I have to do. I think there is a typo in "tilecreation.html", where you mention "ESPG:3875" CRS, but I think it's 3875. But it's not a big deal.

The other thing is, I tried to use Cesium (I signed up and used my own apikey) and it seems to work with provided examples of surveys. But when I tried to use my own survey, left menu bar is not rendered. If I drag it to https://aardgoose.github.io/CaveView.js/fulldemo.html it works (menu bar is displayed). This is the project I was playing with.

Oh, and the link to cesiumtiles.html is dead.

MaticDiba avatar Nov 21 '18 14:11 MaticDiba

Hi,

when the menu bar doesn't come up, its probably an error which isn't handled well. If you can point me to a demo of this I can take a look. The first place is the javascript console in the browser, although if you use the minimized builds the error information will be rather cryptic.

aardgoose avatar Dec 03 '18 20:12 aardgoose