aboutsummaryrefslogtreecommitdiffstats
path: root/src/libgamma/LibgammaException.java
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2022-07-21 12:45:26 +0200
committerMattias Andrée <maandree@kth.se>2022-07-21 12:45:26 +0200
commitd2386fa0e3cc5e80fcfe51f07751d13676655d76 (patch)
tree5bb04bc188f3366fe2e50cca8e05020a8cf3cb6f /src/libgamma/LibgammaException.java
parentmissed to set JAVA_HOME (diff)
downloadjlibgamma-d2386fa0e3cc5e80fcfe51f07751d13676655d76.tar.gz
jlibgamma-d2386fa0e3cc5e80fcfe51f07751d13676655d76.tar.bz2
jlibgamma-d2386fa0e3cc5e80fcfe51f07751d13676655d76.tar.xz
Improve makefile, change license to ISC, change code style, remove dist/
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'src/libgamma/LibgammaException.java')
-rw-r--r--src/libgamma/LibgammaException.java436
1 files changed, 0 insertions, 436 deletions
diff --git a/src/libgamma/LibgammaException.java b/src/libgamma/LibgammaException.java
deleted file mode 100644
index bc8611e..0000000
--- a/src/libgamma/LibgammaException.java
+++ /dev/null
@@ -1,436 +0,0 @@
-/**
- * jlibgamma — Display server abstraction layer for gamma ramp and Java
- * Copyright © 2014 Mattias Andrée (maandree@member.fsf.org)
- *
- * This library is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-package libgamma;
-
-
-/**
- * <p>
- * Class of <tt>libgamma</tt> exceptions including
- * native system exceptions.
- * </p>
- * <p>
- * The class contains constants with <tt>libgamma</tt> error
- * codes. It does however not contain system error codes.
- * </p>
- */
-@SuppressWarnings("serial")
-public class LibgammaException extends Exception
-{
- /**
- * Type initialiser.
- */
- static
- {
- Libgamma.initialise();
- }
-
-
-
- /**
- * This error code is never used. It is only provided
- * so you know its error code if you plan to iterate
- * over all <tt>libgamma</tt> error codes.
- */
- public static final int LIBGAMMA_ERRNO_SET = -1;
-
- /**
- * The selected adjustment method does not exist
- * or has been excluded at compile-time.
- */
- public static final int LIBGAMMA_NO_SUCH_ADJUSTMENT_METHOD = -2;
-
- /**
- * The selected site does not exist.
- */
- public static final int LIBGAMMA_NO_SUCH_SITE = -3;
-
- /**
- * The selected partition does not exist.
- */
- public static final int LIBGAMMA_NO_SUCH_PARTITION = -4;
-
- /**
- * The selected CRTC does not exist.
- */
- public static final int LIBGAMMA_NO_SUCH_CRTC = -5;
-
- /**
- * Counter overflowed when counting the number
- * of available items.
- */
- public static final int LIBGAMMA_IMPOSSIBLE_AMOUNT = -6;
-
- /**
- * The selected connector is disabled, it does
- * not have a CRTC.
- */
- public static final int LIBGAMMA_CONNECTOR_DISABLED = -7;
-
- /**
- * The selected CRTC could not be opened,
- * reason unknown.
- */
- public static final int LIBGAMMA_OPEN_CRTC_FAILED = -8;
-
- /**
- * The CRTC information field is not supported
- * by the adjustment method.
- */
- public static final int LIBGAMMA_CRTC_INFO_NOT_SUPPORTED = -9;
-
- /**
- * Failed to read the current gamma ramps for
- * the selected CRTC, reason unknown.
- */
- public static final int LIBGAMMA_GAMMA_RAMP_READ_FAILED = -10;
-
- /**
- * Failed to write the current gamma ramps for
- * the selected CRTC, reason unknown.
- */
- public static final int LIBGAMMA_GAMMA_RAMP_WRITE_FAILED = -11;
-
- /**
- * The specified ramp sizes does not match the
- * ramps sizes returned by the adjustment methods
- * in response to the query/command.
- */
- public static final int LIBGAMMA_GAMMA_RAMP_SIZE_CHANGED = -12;
-
- /**
- * The specified ramp sizes are not identical
- * which is required by the adjustment method.
- * (Only returned in debug mode.)
- */
- public static final int LIBGAMMA_MIXED_GAMMA_RAMP_SIZE = -13;
-
- /**
- * The specified ramp sizes are not supported
- * by the adjustment method.
- * (Only returned in debug mode.)
- */
- public static final int LIBGAMMA_WRONG_GAMMA_RAMP_SIZE = -14;
-
- /**
- * The adjustment method reported that the gamma
- * ramps size is 1, or perhaps even zero or negative.
- */
- public static final int LIBGAMMA_SINGLETON_GAMMA_RAMP = -15;
-
- /**
- * The adjustment method failed to list
- * available CRTC:s, reason unknown.
- */
- public static final int LIBGAMMA_LIST_CRTCS_FAILED = -16;
-
- /**
- * Failed to acquire mode resources from the
- * adjustment method.
- */
- public static final int LIBGAMMA_ACQUIRING_MODE_RESOURCES_FAILED = -17;
-
- /**
- * The adjustment method reported that a negative
- * number of partitions exists in the site.
- */
- public static final int LIBGAMMA_NEGATIVE_PARTITION_COUNT = -18;
-
- /**
- * The adjustment method reported that a negative
- * number of CRTC:s exists in the partition.
- */
- public static final int LIBGAMMA_NEGATIVE_CRTC_COUNT = -19;
-
- /**
- * Device cannot be access becauses of
- * insufficient permissions.
- */
- public static final int LIBGAMMA_DEVICE_RESTRICTED = -20;
-
- /**
- * Device cannot be access, reason unknown.
- */
- public static final int LIBGAMMA_DEVICE_ACCESS_FAILED = -21;
-
- /**
- * Device cannot be access, membership of the
- * {@link #group_gid} (named by {@link #group_name}
- * (can be {@code null}, if so <tt>errno</tt> may have
- * been set to tell why)) is required.
- */
- public static final int LIBGAMMA_DEVICE_REQUIRE_GROUP = -22;
-
- /**
- * The graphics card appear to have been removed.
- */
- public static final int LIBGAMMA_GRAPHICS_CARD_REMOVED = -23;
-
- /**
- * The state of the requested information is unknown.
- */
- public static final int LIBGAMMA_STATE_UNKNOWN = -24;
-
- /**
- * Failed to determine which connector the
- * CRTC belongs to.
- */
- public static final int LIBGAMMA_CONNECTOR_UNKNOWN = -25;
-
- /**
- * The detected connector type is not listed
- * in this library and has to be updated.
- */
- public static final int LIBGAMMA_CONNECTOR_TYPE_NOT_RECOGNISED = -26;
-
- /**
- * The detected subpixel order is not listed
- * in this library and has to be updated.
- */
- public static final int LIBGAMMA_SUBPIXEL_ORDER_NOT_RECOGNISED = -27;
-
- /**
- * The length of the EDID does not match that
- * of any supported EDID structure revision.
- */
- public static final int LIBGAMMA_EDID_LENGTH_UNSUPPORTED = -28;
-
- /**
- * The magic number in the EDID does not match
- * that of any supported EDID structure revision.
- */
- public static final int LIBGAMMA_EDID_WRONG_MAGIC_NUMBER = -29;
-
- /**
- * The EDID structure revision used by the
- * mointor is not supported.
- */
- public static final int LIBGAMMA_EDID_REVISION_UNSUPPORTED = -30;
-
- /**
- * The gamma characteristics field in the EDID
- * is left unspecified.
- * (This could be considered a non-error.)
- */
- public static final int LIBGAMMA_GAMMA_NOT_SPECIFIED = -31;
-
- /**
- * The checksum in the EDID is incorrect, all
- * request information has been provided
- * by you cannot count on it.
- */
- public static final int LIBGAMMA_EDID_CHECKSUM_ERROR = -32;
-
- /**
- * Both of the errors {@link #LIBGAMMA_GAMMA_NOT_SPECIFIED}
- * and {@link #LIBGAMMA_EDID_CHECKSUM_ERROR} have occurred.
- */
- public static final int LIBGAMMA_GAMMA_NOT_SPECIFIED_AND_EDID_CHECKSUM_ERROR = -33;
-
- /**
- * Failed to query the gamma ramps size from the
- * adjustment method, reason unknown.
- */
- public static final int LIBGAMMA_GAMMA_RAMPS_SIZE_QUERY_FAILED = -34;
-
- /**
- * The selected partition could not be opened,
- * reason unknown.
- */
- public static final int LIBGAMMA_OPEN_PARTITION_FAILED = -35;
-
- /**
- * The selected site could not be opened,
- * reason unknown.
- */
- public static final int LIBGAMMA_OPEN_SITE_FAILED = -36;
-
- /**
- * Failed to query the adjustment method for
- * its protocol version, reason unknown.
- */
- public static final int LIBGAMMA_PROTOCOL_VERSION_QUERY_FAILED = -37;
-
- /**
- * The adjustment method's version of its
- * protocol is not supported.
- */
- public static final int LIBGAMMA_PROTOCOL_VERSION_NOT_SUPPORTED = -38;
-
- /**
- * The adjustment method failed to list
- * available partitions, reason unknown.
- */
- public static final int LIBGAMMA_LIST_PARTITIONS_FAILED = -39;
-
- /**
- * Partition exists by index, but the partition
- * at that index does not exist.
- */
- public static final int LIBGAMMA_NULL_PARTITION = -40;
-
- /**
- * There is not mointor connected to the
- * connector of the selected CRTC.
- */
- public static final int LIBGAMMA_NOT_CONNECTED = -41;
-
- /**
- * Data extraction from a reply from the
- * adjustment method failed, reason unknown.
- */
- public static final int LIBGAMMA_REPLY_VALUE_EXTRACTION_FAILED = -42;
-
- /**
- * No EDID property was found on the output.
- */
- public static final int LIBGAMMA_EDID_NOT_FOUND = -43;
-
- /**
- * Failed to list properties on the output,
- * reason unknown.
- */
- public static final int LIBGAMMA_LIST_PROPERTIES_FAILED = -44;
-
- /**
- * Failed to query a property's value from
- * the output, reason unknown.
- */
- public static final int LIBGAMMA_PROPERTY_VALUE_QUERY_FAILED = -45;
-
- /**
- * A request for information on an output
- * failed, reason unknown.
- */
- public static final int LIBGAMMA_OUTPUT_INFORMATION_QUERY_FAILED = -46;
-
-
- /**
- * The number of the libgamma error with the
- * lowest number. If this is lower than the
- * number your program thinks it should be sould
- * update your program for new errors.
- */
- public static final int LIBGAMMA_ERROR_MIN = -46;
-
-
-
- /**
- * Constructor.
- *
- * @param error_code The error code.
- */
- public LibgammaException(int error_code)
- {
- this.error_code = error_code;
- if (error_code == LIBGAMMA_DEVICE_REQUIRE_GROUP)
- { this.group_gid = libgamma_group_gid();
- this.group_name = libgamma_group_name();
- }
- else
- { this.group_gid = 0;
- this.group_name = null;
- }
- if (error_code < 0)
- this.string = name_of_error(error_code);
- else
- this.string = strerror(error_code);
- }
-
-
- /**
- * The error code.
- * Cannot be {@link #LIBGAMMA_ERRNO_SET}.
- */
- public final int error_code;
-
- /**
- * Group that the user needs to be a member of if
- * {@link #error_code} is {@link #LIBGAMMA_DEVICE_REQUIRE_GROUP}.
- */
- public final int group_gid;
-
- /**
- * Group that the user needs to be a member of if
- * {@link #error_code} is {@link #LIBGAMMA_DEVICE_REQUIRE_GROUP},
- * {@code null} if the name of the group {@link #group_gid}
- * cannot be determined.
- */
- public final String group_name;
-
- /**
- * Name of textual description of the error.
- */
- public final String string;
-
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String toString()
- {
- return this.string;
- }
-
-
-
- /**
- * Returns the name of the definition associated with
- * a <tt>libgamma</tt> error code.
- *
- * @param value The error code.
- * @return The name of the definition associated with the error code,
- * {@code null} if the error code does not exist.
- */
- public static native String name_of_error(int value);
-
- /**
- * Return the value of a <tt>libgamma</tt> error definition
- * refered to by name.
- *
- * @param name The name of the definition associated with the error code.
- * @return The error code, zero if the name is {@code null}
- * or does not refer to a <tt>libgamma</tt> error.
- */
- public static native int value_of_error(String name);
-
-
- /**
- * Acquire the value that should go to {@link #group_gid}.
- *
- * @return The value that should go to {@link #group_gid}.
- */
- private static native int libgamma_group_gid();
-
- /**
- * Acquire the value that should go to {@link #group_name}.
- *
- * @return The value that should go to {@link #group_name}.
- */
- private static native String libgamma_group_name();
-
- /**
- * Get a textual description of a system error code.
- *
- * @param error_code The error code.
- * @return A textual description of the error code.
- */
- private static native String strerror(int error_code);
-
-}
-