LINUX (UBUNTU OS)

Thread for LINUX How-To

Cafe Con Leche - Ubuntu How To

August 23, 2007

Cafe Con Leche actually is a library project that intends to make the development of internet cafe programs easier, it consists of two library : libccls is used to make the server part, and libcclc is used to make the client. But The developers also made a GPL version Billing based on these library called CCLFox.

CCL is very popular here in Indonesia where Internet Cafes are starting to turn to Free Open Source Operating System since Microsoft and the Police starts sweeping internet cafes for illegal use of Microsoft Windows. But nonetheless it’s hard to find a How to on installing and using libCCL and CCLfox, especially on Ubuntu, I’ve done some googling last night and didn’t find anything satisfying. I’ve found some very good reference tough, like the one one linux.or.id and at Mr.Handri’s Blog.This How To is actually based on Linux Mint 3.0 but i think it’ll work just fine on Fiesty and you can download CCL here.

==Common Installation==

Both side of the application (client & server) has to meet their depdencies, since this is not a debian package, we have to install the dependencies manually. CCL depdencies are

* sqlite3
* glib2.0
* libfox1.4
* openssl

so on both computer (clien & server) run these command :

$ sudo apt-get install sqlite3 libsqlite3-dev

$ sudo apt-get install libfox1.4 libfox1.4-dev

$ sudo apt-get install libglib2.0-dev

$ sudo apt-get install libssl-dev

Don’t forget the build essentials for compiling from source :

$sudo apt-get install build-essential

Then edit your /etc/ld.so.conf file with :

$gksudo gedit /etc/ld.so.conf

and add these lines :

/usr/lib
/usr/local/lib

Then execute this :

$sudo ldconfig

== Billing Server ==

for the server side you’ll need these to files :

cclfox-0.7.0.tar.bz2
libccls-0.7.0.tar.bz2

Put these files on your home folder an do these steps :

$tar -xjvf libccls-0.7.0.tar.bz2
$cd libccls-0.7.0
$./configure
$make
$sudo make install
$cd ..
$tar -xjvf cclfox-0.7.0.tar.bz2
$cd cclfox-0.7.0
$./configure
$make
$sudo make install

Then create a launcher on your desktop and add :

cclfox -nossl

on the “command” text box

== Billing Client ==

for the server side you’ll need these to files :

cclcfox-0.7.0.tar.bz2
libcclc-0.7.0.tar.bz2

Put these files on your home folder an do these steps :

$tar -xjvf libcclc-0.7.0.tar.bz2
$cd libcclc-0.7.0
$./configure
$make
$sudo make install
$cd ..
$tar -xjvf cclcfox-0.7.0.tar.bz2
$cd cclcfox-0.7.0
$./configure
$make
$sudo make install

Then create a launcher on your desktop and add :

cclcfox -host <server’s ip> -name <client name> -nossl

on the “command” text box

That’s about it! Now my internet cafe is 100% sugar *M$* free!

Trouble Shooting :

this errors bellow usually happens because we have installed the depdencies but we didn’t installed the dev of the library that is used for compiling the CCL from source :

1. configure: error: please install openssl
cure : $sudo apt-get install libssl-dev
2. configure: error: please install sqlite3
cure : $sudo apt-get install libsqlite3-dev
3. configure: error: please install glib
cure : $sudo apt-get install libglib2.0-dev
4. configure: error: please install fox
cure : $sudo apt-get install libfox1.4-dev
5. configure: error: installation or configuration problem: C++ compiler cannot create executables.
cure :$sudo apt-get install build-essential

Java 3D Implementation - OpenGL vs DirectX

This document is to track some of the nuiances of the differences between running either the OpenGL or DirectX versions of Java 3D.

Platform

Obviously the DirectX version of Java 3D is only available for Windows platforms.

Features

Our opinion is that the OpenGL implementation of Java 3D is more feature rich than the DirectX implementation. Java3D 1.2.1 DirectX implementation uses DirectX 7.0. Java 3D 1.3 will use DirectX 8.0.

Performance

With OpenGL as the primary platform independent implementation we believe Sun has put more effort into the OpenGL implementation. Currently the OpenGL implementation appears to deliver roughly 30% to 50% better frame rates.

Stability

Since OpenGL was Sun's first implementation and hence Java 3D has had more history with OpenGL we believe that OpenGL should be more stable. However in bug testing a major application we found the DirectX 1.2.1 implementation to be far more stable than the OpenGL 1.2.1 implementation.

Details

Features

Features not supported by Java3D v1.2.1 DirectX version:

* Line width
* Line antialiasing
* Point size
* Point antialiasing
* PolygonAttributes backFaceNormalFlip
* RenderingAttributes ROP_XOR
* 3D Texture
* Texture color table

Performance

Typically resolutions below 16 bpp do not provide hardware acceleration (i.e. 256 color mode is unsupported).

Under Win98, OpenGL hardware acceleration is not supported for multiple monitors. You either need to disable one monitor in the display setting or switch to the DirectX version.

Stability



Technobabble

Interpretation of depth buffer values

For OpenGL version,
----------------------
glDrawPixels(width, height, GL_DEPTH_COMPONENT, GL_FLOAT, floatData);
glReadPixels(xOffset, yoffset, width, height, GL_DEPTH_COMPONENT, GL_FLOAT, floatData);

are used, it is up to the driver to handle the case when there is no z-buffer or it is not readable.


For D3D version using DX 7.0 (i.e. Java3D v1.2.1 )
-------------------------------------------------
If device has no z surface needed, i.e. dpcTriCaps.dwRasterCaps & D3DPRASTERCAPS_ZBUFFERLESSHSR then all the read/write depthcomponent will silently ignore.

Otherwise, the z surface is created. If during z surface lock D3D return fail, a message will printout "Fail to lock surface " with error code and operation return without doing anything.


For D3D version using DX 8.0 (i.e. next Java3D 1.3 release)
----------------------------------------------
The specification only allow locking the depth surface to read/write when D3DFMT_D16_LOCKABLE format is used. But this means we can't use stencil buffer by specific format D3DFMT_D24S8 for features such as DecalGroup. Thus DepthComponent can't coexist with other features in Java3D that required stencil buffer. Right now the depth format available is search with stencil buffer has priority. So under the nvidia driver, if display mode is 16 bit than DepthComponent is support.

If the z surface fail to get using DX function GetDepthStencilSurface(), an error message will display when -Dj3d.debug=true is used on startup. All read/write DepthComponent is ignored. Same thing happen when lock surface fail.

Further References

OpenGL Information for Microsoft Windows can be found at: http://www.opengl.org/developers/faqs/technical/mswindows.htm

Direct3D vs. OpenGL: A Comparison - http://www.xmission.com/~legalize/d3d-vs-opengl.html

DirectX 9.0c on Linux with Wine

About DirectX

Microsoft DirectX is a collection of application programming interfaces for handling tasks related to multimedia, especially game programming and video, on Microsoft platforms. Originally, the names of these APIs all began with Direct, such as Direct3D, DirectDraw, DirectMusic, DirectPlay, DirectSound, and so forth. DirectX, then, was the generic term for all of these Direct-something APIs, and that term became the name of the collection. Over the intervening years, some of these APIs have been deprecated and replaced, so that this naming convention is no longer absolute. In fact, the X has caught on to the point that it has replaced Direct as the common part in the names of new DirectX technologies, including XAct, XInput, and so forth.

Direct3D (the 3D graphics API within DirectX) is widely used in the development of computer games for Microsoft Windows, Microsoft Xbox, and Microsoft Xbox 360. Direct3D is also used by other software applications for visualization and graphics tasks, most notably among the engineering sector for CAD/CAM, because of its ability to quickly render high-quality 3D graphics using DirectX-compatible graphics hardware. As Direct3D is the most widely recognized API in DirectX, it is not uncommon to see the name DirectX used in place of Direct3D.

Wine configuration

This is with a clean configuration directory and running in a 1024x768 virtual desktop.

$ winecfg

Once the .wine directory is built the configuration tool will start and you can set a virtual desktop in the graphics tab if you wish. This is a good time to also set your Audio driver in the Audio tab.

next up is to install a native mscoree.dll and streamci.dll into /system32 from a windows install and set them to native Windows.

You will need to set a large number of dlls to native for the install to work properly. Here is the full list of dlls that needs to be set.

[Software\\Wine\\DllOverrides] 1195992268
"d3d8"="builtin"
"d3d9"="builtin"
"d3dim"="native"
"d3drm"="native"
"d3dx8"="native"
"d3dxof"="native"
"dciman32"="native"
"ddrawex"="native"
"devenum"="native"
"dinput"="builtin"
"dinput8"="builtin"
"dmband"="native"
"dmcompos"="native"
"dmime"="native"
"dmloader"="native"
"dmscript"="native"
"dmstyle"="native"
"dmsynth"="native"
"dmusic"="native"
"dmusic32"="native"
"dnsapi"="native"
"dplay"="native"
"dplayx"="native"
"dpnaddr"="native"
"dpnet"="native"
"dpnhpast"="native"
"dpnlobby"="native"
"dsound"="builtin"
"dswave"="native"
"dxdiagn"="native"
"mscoree"="native"
"msdmo"="native"
"qcap"="native"
"quartz"="native"
"streamci"="native"

You can set all the dlls in winecfg under the "Libraries" tab or just set the first dll "d3d8"="builtin" and then go to .wine/user.reg and find the DLL override section [Software\\Wine\\DllOverrides] and copy the above list under it.

Installing Directx

Download DirectX 9.0c November release from here.

The directx_nov2007_redist.exe executable will extract the installer files to a directory of your choice.

tom@tuxonfire ~ $ wine directx_nov2007_redist.exe
fixme:advapi:DecryptFileA "z:\\home\\tom\\directx-9\\" 00000000
fixme:midi:OSS_MidiInit Synthesizer supports MIDI in. Not yet supported.
tom@tuxonfire ~ $

Now cd to the directory where you choose to extract the DirectX installer and run DXSETUP.EXE.

tom@tuxonfire ~ $ cd /home/tom/directx-9
tom@tuxonfire ~/directx-9 $ wine DXSETUP.EXE
fixme:midi:OSS_MidiInit Synthesizer supports MIDI in. Not yet supported.

You will now want to run the setup a second time.... If you don't you will receive a network error and dplay wont function correctly.

Now lets run dxdiag.exe

tom@tuxonfire ~/directx-9 $ cd /home/tom/.wine/drive_c/windows/system32
tom@tuxonfire ~/.wine/drive_c/windows/system32 $ wine dxdiag.exe
fixme:ole:CoInitializeSecurity ((nil),-1,(nil),(nil),1,3,(nil),0,(nil)) - stub!

We can now test ddraw, ddraw 3D, D3D8, and D3D9

Direct Sound test:

Now we need to install gm.dls to test Direct Music, this driver file goes into ~/.wine/drive_c/windows/system32/drivers

Direct Play test:

You will notice in system32 d3dx9_24.dll up to d3dx9_36.dll is now installed, this really helps when you run into a game that needs these additional DirectX dlls.

Now you have the option to run most DirectX dlls in native or builtin mode, for example if you have a game that's crashing on the builtin Wine quartz.dll you can test the game with the native Windows dll to see if this will improve the situation.

Keep in mind d3d8, d3d9, ddraw will only work as builtin, and in most cases you should try to use builtin dsound and dinput. I have had limited success with (dsound and dinput) in native Windows mode btw... The reason why these dlls have to be used in builtin mode is there need for direct access to your hardware. direct music and direct play can be used in native windows mode in most circumstances.