HallScheme
Description
HallScheme is a lightweight simple library for creating rectangle halls.
Demo
Integration
1) Add as a dependency to your build.gradle
:
dependencies {
compile 'com.github.Nublo:hallscheme:1.1.1'
}
2) Add by.anatoldeveloper.ZoomableImage
to your layout XML file. Content is automatically centered within free space.
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<by.anatoldeveloper.hallscheme.view.ZoomableImageView
android:id="@+id/zoomable_image"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</RelativeLayout>
3) Customize Seat
interface:
public class SeatExample implements Seat {
public int id;
public int color = Color.RED;
public String marker;
public String selectedSeatMarker;
public HallScheme.SeatStatus status;
@Override
public int id() {
return id;
}
@Override
public int color() {
return color;
}
@Override
public String marker() {
return marker;
}
@Override
public String selectedSeat() {
return selectedSeatMarker;
}
@Override
public HallScheme.SeatStatus status() {
return status;
}
@Override
public void setStatus(HallScheme.SeatStatus status) {
this.status = status;
}
}
4) Attach ZoomableImage to HallScheme
and add a 2-dimesional Seat
array:
ZoomableImageView imageView = (ZoomableImageView) rootView.findViewById(R.id.zoomable_image);
Seat seats[][] = new Seat[10][10];
HallScheme scheme = new HallScheme(imageView, seats, getActivity());
5) Set SeatListener
to HallScheme
to handle click events on seats:
scheme.setSeatListener(new SeatListener() {
@Override
public void selectSeat(int id) {
Toast.makeText(getActivity(), "select seat " + id, Toast.LENGTH_SHORT).show();
}
@Override
public void unSelectSeat(int id) {
Toast.makeText(getActivity(), "unSelect seat " + id, Toast.LENGTH_SHORT).show();
}
});
Seat interface
To use the library you should implement custom Seat
. It has the following methods:
a) int id()
should return current id
for current Seat
. It will also be later returned when you attach SeatListener
for scheme.
b) int color()
should return the color of the checked Seat
.
c) String marker()
should return text representation for empty Seat
. For example you can use it to see row and column.
d) String selectedSeat();
should return Seat
number when the Seat
is checked.
e) HallScheme.SeatStatus status();
should return current state of the Seat
. The following statuses are supported:
FREE
- seat is free and can be checked;CHOSEN
- seat is chosen and can be unchecked;BUSY
- seat cannot be used;INFO
- the seat is empty, but you can use to show some text there;EMPTY
- the seat is empty.
f) void setStatus(HallScheme.SeatStatus status);
update current Seat
status.
Features:
a) Zoomable image.
Zooming can be enabled/disabled either from code:
imageView.setZoomByDoubleTap(false);
or from xml:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:hallscheme="http://schemas.android.com/apk/res"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#FFD8E2E6">
<by.anatoldeveloper.hallscheme.view.ZoomableImageView
android:id="@+id/zoomable_image"
android:layout_width="match_parent"
android:layout_height="match_parent"
hallscheme:doubleTap="false"/>
</RelativeLayout>
b) Fling while touching image.
c) Smooth animation available either on double tap or on gesture move.
d) Showing scheme scene from any of 4 sides.
hallScheme.setScenePosition(ScenePosition.NORTH);
NORTH
SOUTH
EAST
WEST
e) Adding text to show row or hall numbers.
f) Handling clicking on seats on your scheme.
g) Full customization for drawing:
-
Setting background color for scheme:
scheme.setBackgroundColor(Color.RED);
-
Setting color for
BUSY
seats:scheme.setUnavailableSeatBackgroundColor(Color.RED);
-
Setting background color for
CHOSEN
seats:scheme.setChosenSeatBackgroundColor(Color.RED);
-
Setting text color for
CHOSEN
seats:scheme.setChosenSeatTextColor(Color.RED);
-
Setting color for
INFO
seats:scheme.setMarkerColor(Color.RED);
-
Setting text color for Scene:
scheme.setScenePaintColor(Color.RED);
-
Setting background color for Scene:
scheme.setSceneBackgroundColor(Color.RED);
-
Setting custom typeface for Scene:
scheme.setTypeface(typeface);
h) Setting custom name for scene:
scheme.setSceneName("Custom name");
i) Setting limit of checked seats and set listener for this event:
scheme.setMaxSelectedSeats(4);
scheme.setMaxSeatsClickListener(new MaxSeatsClickListener() {
@Override
public void maxSeatsReached(int id) {
// Do something
}
});
By default it is unlimitted. So user can check as many seats as he wants.
j) Programmatically click on scheme:
scheme.clickSchemeProgrammatically(3, 4);
So if seat was checked it becomes unchecked and Seatlistener
will be notified. If seat was unchecked and limit is not reached seat becomes checked and SeatListener
will be notified, otherway(when limit reached) seat will not be checked and MaxSeatsListener
will be notified.
k) Adding seat areas.
Seat area will be drawn like a solid rectangle on scene and can have size from 1x1 block to all scheme. When user is clicking on seat area listener will be notified. Clicking on seat area is not counting in maxSelectedSeats
.
You can see how to use seat areas in examples. Main principle like with seats. You should set left top corner, width, height and color. Name for seat area is not used in current library implementation.
Restrictions
Image is currently drawing on standart Bitmap
. Maximum size of Bitmap
depends on underlying OpenGL implementation and it varies depending on device. It shouldn't be less then 2048x2048
. With current implementation your hall dimension(either rows or columns) shouldn't be more then 58
. Maximum scheme that can be drawn is 58x58
. Of course, if you know that devices using your app will have bigger maximum size - you can draw larger schemes.
ChangeLog
Version 1.1.1:
- Remove dependency from appcompat library
Version 1.1.0:
- Ability to set custom typeface
- Disable zooming by double tap
- Programmatically click seat on scheme
- Limiting checked seats
- Added seat areas
License
The MIT License (MIT)
Copyright (c) 2016 Varyvonchyk Anatol
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.