19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.graphics; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class LinearGradient extends Shader { 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Create a shader that draws a linear gradient along a line. 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param x0 The x-coordinate for the start of the gradient line 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param y0 The y-coordinate for the start of the gradient line 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param x1 The x-coordinate for the end of the gradient line 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param y1 The y-coordinate for the end of the gradient line 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param colors The colors to be distributed along the gradient line 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param positions May be null. The relative positions [0..1] of 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project each corresponding color in the colors array. If this is null, 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project the the colors are distributed evenly along the gradient line. 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param tile The Shader tiling mode 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LinearGradient(float x0, float y0, float x1, float y1, 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int colors[], float positions[], TileMode tile) { 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors.length < 2) { 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("needs >= 2 number of colors"); 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (positions != null && colors.length != positions.length) { 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("color and position arrays must be of equal length"); 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_instance = nativeCreate1(x0, y0, x1, y1, colors, positions, tile.nativeInt); 4006f96e2652e4855b6520ad9dd70583677605b79aRomain Guy native_shader = nativePostCreate1(native_instance, x0, y0, x1, y1, colors, positions, 4106f96e2652e4855b6520ad9dd70583677605b79aRomain Guy tile.nativeInt); 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Create a shader that draws a linear gradient along a line. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param x0 The x-coordinate for the start of the gradient line 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param y0 The y-coordinate for the start of the gradient line 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param x1 The x-coordinate for the end of the gradient line 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param y1 The y-coordinate for the end of the gradient line 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param color0 The color at the start of the gradient line. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param color1 The color at the end of the gradient line. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @param tile The Shader tiling mode 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LinearGradient(float x0, float y0, float x1, float y1, 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int color0, int color1, TileMode tile) { 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_instance = nativeCreate2(x0, y0, x1, y1, color0, color1, tile.nativeInt); 5606f96e2652e4855b6520ad9dd70583677605b79aRomain Guy native_shader = nativePostCreate2(native_instance, x0, y0, x1, y1, color0, color1, 5706f96e2652e4855b6520ad9dd70583677605b79aRomain Guy tile.nativeInt); 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 607fac2e18339f765320d759e8d4c090f92431959eRomain Guy private native int nativeCreate1(float x0, float y0, float x1, float y1, 617fac2e18339f765320d759e8d4c090f92431959eRomain Guy int colors[], float positions[], int tileMode); 627fac2e18339f765320d759e8d4c090f92431959eRomain Guy private native int nativeCreate2(float x0, float y0, float x1, float y1, 637fac2e18339f765320d759e8d4c090f92431959eRomain Guy int color0, int color1, int tileMode); 6406f96e2652e4855b6520ad9dd70583677605b79aRomain Guy private native int nativePostCreate1(int native_shader, float x0, float y0, float x1, float y1, 6506f96e2652e4855b6520ad9dd70583677605b79aRomain Guy int colors[], float positions[], int tileMode); 6606f96e2652e4855b6520ad9dd70583677605b79aRomain Guy private native int nativePostCreate2(int native_shader, float x0, float y0, float x1, float y1, 6706f96e2652e4855b6520ad9dd70583677605b79aRomain Guy int color0, int color1, int tileMode); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 69