mirror
/
fireblade-ecs
mirror of https://github.com/fireblade-engine/ecs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README

This commit is contained in:
Christian Treffs 2018-09-29 19:18:55 +02:00
parent 2faf91fb2d
commit 1a11b8336c
1 changed files with 41 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
README.md
View File

@ -1,6 +1,6 @@
# Fireblade ECS (Entity-Component-System) # Fireblade ECS (Entity-Component-System)
[![Build Status](https://travis-ci.com/fireblade-engine/ecs.svg?branch=master)](https://travis-ci.com/fireblade-engine/ecs) [![Build Status](https://travis-ci.com/fireblade-engine/ecs.svg?branch=master)](https://travis-ci.com/fireblade-engine/ecs)
[![version 0.4.3](https://img.shields.io/badge/version-0.4.3-brightgreen.svg)](releases/tag/v0.4.3) [![version 0.5.0](https://img.shields.io/badge/version-0.5.0-brightgreen.svg)](releases/tag/v0.5.0)
[![license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE) [![license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
[![swift version](https://img.shields.io/badge/swift-4.2-brightgreen.svg)](#) [![swift version](https://img.shields.io/badge/swift-4.2-brightgreen.svg)](#)
[![platforms](https://img.shields.io/badge/platform-macOS%20|%20iOS%20|%20linux-brightgreen.svg)](#) [![platforms](https://img.shields.io/badge/platform-macOS%20|%20iOS%20|%20linux-brightgreen.svg)](#)
@ -33,7 +33,7 @@ import PackageDescription
let package = Package( let package = Package(
name: "YourPackageName", name: "YourPackageName",
dependencies: [ dependencies: [
.package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.4.3") .package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.5.0")
], ],
targets: [ targets: [
.target( .target(
@ -87,28 +87,26 @@ Create a family by calling `.family` with a set of traits on the nexus.
A family that containts only entities with a `Movement` and `PlayerInput` component, but no `Texture` component is created by A family that containts only entities with a `Movement` and `PlayerInput` component, but no `Texture` component is created by
```swift ```swift
let family = nexus.family(requiresAll: [Movement.self, PlayerInput.self], let family = nexus.family(requiresAll: Movement.self, PlayerInput.self,
excludesAll: [Texture.self], excludesAll: Texture.self)
needsAtLeastOne: [Name.self])
``` ```
These entities are cached in the nexus for efficient access and iteration. These entities are cached in the nexus for efficient access and iteration.
Iterate family members by calling `.iterate` on the family you want to iterate over. Families conform to the [LazySequenceProtocol](https://developer.apple.com/documentation/swift/lazysequenceprotocol) so that members (components)
`iterate` provides a closure whose parameters start with the entity identifier (entityId) of the current entity, may be iterated and accessed like any other sequence in Swift.
followed by the typesafe component instances of the current entity that you may provide in your desired order. Access a familiy's components directly on the family instance. To get each entity to the accessed components call `family.entityAndComponents`.
If you are only interested in a family's entities call `family.entities`.
```swift ```swift
class PlayerMovementSystem { class PlayerMovementSystem {
let family = nexus.family(requiresAll: [Movement.self, PlayerInput.self], let family = nexus.family(requiresAll: Movement.self, PlayerInput.self,
excludesAll: [Texture.self], excludesAll: Texture.self)
needsAtLeastOne: [Name.self])
func update() { func update() {
family.iterate { (mov: Movement!, input: PlayerInput!, name: Name?) in family
.forEach { (mov: Movement, input: PlayerInput) in
// position & velocity for the current entity // position & velocity component for the current entity
// we know that we will have this component so we force unwrap the component
// instance parameter already for easy handling inside the closure
// get properties // get properties
_ = mov.position _ = mov.position
@ -122,20 +120,41 @@ class PlayerMovementSystem {
_ = input.command _ = input.command
... ...
// optional name component that may or may not be part of the current entity }
_ = name?.name }
...
func update2() {
family
.entityAndComponents
.forEach { (entity: Entity, mov: Movement, input: PlayerInput) in
// the currenty entity instance
_ = entity
// position & velocity component for the current entity
// get properties
_ = mov.position
_ = mov.velocity
}
}
func update3() {
family
.entities
.forEach { (entity: Entity) in
// the currenty entity instance
_ = entity
} }
} }
} }
``` ```
See the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo) to get started. See the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo) to get started.
<!--## Contributing
Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us.-->
## Versioning ## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](tags). We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](tags).