/** * Copyright 2023 JogAmp Community. All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * * 2. Redistributions 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. * * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * The views and conclusions contained in the software and documentation are those of the * authors and should not be interpreted as representing official policies, either expressed * or implied, of JogAmp Community. */ package com.jogamp.openal; import com.jogamp.common.os.Platform; import com.jogamp.common.util.VersionNumber; import com.jogamp.common.util.VersionNumberString; public class ALVersion { private final String vendor; private final String renderer; private final VersionNumberString version; private final VersionNumberString vendorVersion; /** * Returns the optional vendor version at the end of the * AL_VERSION string if exists, otherwise the {@link VersionNumberString#zeroVersion zero version} instance. *
     *   1.1.0 (1.1 ALSOFT 1.23.1)
     * 
*/ private static final VersionNumberString getVendorVersion(final VersionNumberString version) { // Skip the 1st AL version String str = version.getVersionString().substring(version.endOfStringMatch()).trim(); while ( str.length() > 0 ) { final VersionNumberString vv = new VersionNumberString(str, VersionNumber.getDefaultVersionNumberPattern()); final int eosm = vv.endOfStringMatch(); if( 0 < eosm ) { if( vv.hasMajor() && vv.hasMinor() ) { // Requires at least a defined major and minor version component! return vv; } str = str.substring( eosm ).trim(); } else { break; // no match } } return VersionNumberString.zeroVersion; } /** * ALVersion Ctor *

* The given {@link AL} is being used and assumed having a current {@link ALCcontext}, * w/o any resources being allocated. *

* @param al {@link AL} instance with a current {@link ALCcontext}. */ public ALVersion(final AL al) { vendor = al.alGetString(ALConstants.AL_VENDOR); renderer = al.alGetString(ALConstants.AL_RENDERER); version = new VersionNumberString(al.alGetString(ALConstants.AL_VERSION)); vendorVersion = getVendorVersion(version); } /** * ALVersion Ctor *

* The given {@link ALC} is being used and {@Link ALCdevice} and {@link ALCcontext} are allocated, * made current and finally being released. *

* @param alc static {@link ALC} instance */ public ALVersion(final ALC alc) { final ALCdevice device = alc.alcOpenDevice(null); final ALCcontext context = alc.alcCreateContext(device, null); alc.alcMakeContextCurrent(context); final AL al = ALFactory.getAL(); // valid after makeContextCurrent(..) vendor = al.alGetString(ALConstants.AL_VENDOR); renderer = al.alGetString(ALConstants.AL_RENDERER); version = new VersionNumberString(al.alGetString(ALConstants.AL_VERSION)); vendorVersion = getVendorVersion(version); alc.alcMakeContextCurrent(null); alc.alcDestroyContext(context); alc.alcCloseDevice(device); } /** * Return the AL context implementation vendor. */ public String getVendor() { return vendor; } /** * Return the AL context implementation renderer. */ public String getRenderer() { return renderer; } /** * Return the AL context implementation version. */ public VersionNumberString getVersion() { return version; } /** * Returns the optional vendor version at the end of the * AL_VERSION string if exists, otherwise the {@link VersionNumberString#zeroVersion zero version} instance. *
     *   1.1.0 (1.1 ALSOFT 1.23.1)
     * 
*/ public VersionNumberString getVendorVersion() { return vendorVersion; } @Override public String toString() { return toString(false, null).toString(); } public StringBuilder toString(final boolean withNewline, StringBuilder sb) { if( null == sb ) { sb = new StringBuilder(); } if( withNewline ) { sb.append("AL_VENDOR ").append(getVendor()); sb.append(Platform.getNewline()); sb.append("AL_RENDERER ").append(getRenderer()); sb.append(Platform.getNewline()); sb.append("AL_VERSION ").append(getVersion()); sb.append(Platform.getNewline()); sb.append("AL_VENDOR_VERS ").append(getVendorVersion()); sb.append(Platform.getNewline()); } else { sb.append("vendor ").append(getVendor()); sb.append(", renderer ").append(getRenderer()); sb.append(", version ").append(getVersion()); sb.append(", vendorVersion ").append(getVendorVersion()); } return sb; } }